goromal/agent-skills

Integrar, classificar, organizar ou encaminhar notas ITNS (“Integrate These Notes Somewhere”) de uma página nomeada do Notion para subpáginas apropriadas. Use quando o usuário mencionar ITNS, solicitar o processamento de um repositório de notas do Notion ou nomear uma página cujas notas soltas devem ser arquivadas. Resolva nomes de página por meio de ~/configs/goromail-categories.csv, mova notas óbvias automaticamente e exija decisão do usuário para cada pouso ambíguo ou nova subpágina.

O que é agent-skills?

Este skill foi projetado para agentes de IA que trabalham com o Notion, permitindo organizar notas soltas (ITNS) de forma inteligente e segura. A funcionalidade principal é processar uma página de origem no Notion, identificando notas individuais (blocos ou grupos de blocos contíguos que formam um pensamento contínuo) e movendo-as para subpáginas de destino adequadas, baseando-se em um arquivo de categorias CSV. O skill prioriza a preservação total do conteúdo das notas, sem resumos, reescritas ou exclusões não autorizadas. Ele utiliza o servidor MCP do Notion para listar subpáginas e blocos, e toma decisões automáticas apenas quando há correspondência semântica forte e inequívoca com uma única subpágina existente. Caso contrário, apresenta opções e recomendações ao usuário, aguardando sua aprovação antes de mover qualquer nota ambígua ou criar novas categorias. Isso garante um fluxo de trabalho colaborativo e seguro, evitando erros de organização. O skill é útil para desenvolvedores e usuários avançados do Notion que desejam automatizar a triagem de notas, mantendo controle total sobre decisões críticas.

Funciona com~Claude Code~Codex CLI~Cursor

npx skills add https://github.com/goromal/agent-skills/tree/HEAD/skills/itns-notes

Documentação

Processar notas ITNS

Use o servidor MCP do Notion instalado. Preserve a redação, formatação, links, datas, marcadores de prioridade, tipos de bloco, ordem e filhos aninhados de cada nota. Não resuma, reescreva, divida, mescle, deduplique ou exclua conteúdo, a menos que o usuário solicite explicitamente.

Resolver a página de origem

Corresponda exatamente e sem diferenciar maiúsculas/minúsculas o nome da página fornecido pelo usuário com a primeira coluna de ~/configs/goromail-categories.csv.
Use o ID de página do Notion correspondente na segunda coluna.
Pare e pergunte se não houver correspondência exata ou mais de uma correspondência exata. Nunca adivinhe um ID a partir de um nome semelhante.

Descobrir notas e destinos

Chame notion_list_subpages na página de origem para coletar destinos candidatos.
Chame notion_list_blocks com recursive: true na página de origem. Trate um bloco pai e todos os seus descendentes como uma árvore de notas indivisível.
Trate parágrafos adjacentes de nível superior, itens de lista, blocos de código e outra prosa como uma única nota composta quando seu conteúdo formar claramente um pensamento contínuo. Se seu limite for incerto, classifique o limite como ambíguo e pergunte ao usuário.
Exclua cabeçalhos, blocos de página filho, links de menção a páginas e outros blocos de navegação ou estruturais. Quando existir um cabeçalho Repositório, use o conteúdo solto após ele como a região de nota de origem. Se nenhum limite confiável de nota de origem existir, pergunte antes de mover qualquer coisa.
Inspecione o conteúdo relevante dos destinos com listagem recursiva de blocos. Classifique a partir tanto do título do destino quanto de seu assunto existente, não apenas de seu título.
Para um link opaco ou rótulo vago, inspecione o material vinculado quando o acesso estiver disponível. Pergunte em vez de inferir quando seu assunto permanecer incerto.

Decidir automaticamente ou perguntar

Mova uma nota automaticamente somente quando todas as condições a seguir forem verdadeiras:

exatamente uma subpágina existente for uma correspondência semântica forte;
a nota completa e seus limites forem compreendidos;
a movimentação não exigir reescrita, divisão, mesclagem ou invenção de categoria.

Trate todos os outros casos como ambíguos. Apresente a nota completa ou uma prévia fiel e compacta, os destinos plausíveis e uma recomendação com uma breve justificativa. Aguarde a decisão do usuário antes de escrever essa nota. Sempre pergunte antes de criar ou nomear uma nova subpágina.

Continue processando notas óbvias independentes enquanto notas ambíguas aguardam uma decisão. Não deixe que um pouso óbvio decida silenciosamente um pouso ambíguo relacionado.

Executar e verificar movimentações

Mova uma árvore de nota de nível superior com notion_move_block; seus descendentes se movem com ela.
Mova uma nota composta feita de blocos adjacentes de nível superior com notion_move_blocks. Passe os IDs dos blocos uma vez, em sua ordem original, para um único destino.
Crie uma categoria aprovada pelo usuário com notion_create_subpage, em seguida mova apenas as notas aprovadas para ela.
Nunca emule uma movimentação com anexo de texto com perda seguido de exclusão.
Após cada lote, liste a origem e o destino novamente. Verifique se cada bloco de origem está ausente, cada bloco de destino está presente em ordem, as contagens de filhos correspondem e os tipos de bloco e o texto foram preservados.
Se qualquer operação falhar parcialmente, pare as gravações subsequentes, inspecione ambas as páginas e relate exatamente os blocos copiados, arquivados, restantes ou duplicados antes de tentar reparar.
Se a listagem recursiva ou movimentações em lote ordenadas não estiverem disponíveis, pare e relate que o servidor MCP do Notion deve ser implantado ou atualizado antes que notas compostas possam ser processadas com segurança.

Termine com um registro conciso das movimentações automáticas, movimentações aprovadas pelo usuário, páginas criadas, ambiguidades adiadas e resultados da verificação.