goromal/agent-skills

Integra, ordena, organiza o canaliza notas ITNS ("Integrate These Notes Somewhere") desde una página de Notion designada hacia las subpáginas apropiadas.

¿Qué es agent-skills?

Esta habilidad permite a un agente de IA procesar un repositorio de notas sueltas (denominadas ITNS, por "Integrate These Notes Somewhere") desde una página de Notion. Utiliza un servidor MCP de Notion instalado para mover cada nota, preservando su redacción, formato, enlaces, fechas y tipo de bloque, sin resumir ni modificar el contenido a menos que el usuario lo solicite explícitamente. Primero, resuelve la página de origen consultando el archivo `~/configs/goromail-categories.csv` para obtener el ID de la página de Notion correspondiente, deteniéndose y preguntando si no hay una coincidencia exacta. Luego descubre las notas y los destinos potenciales listando las subpáginas y los bloques de la página de origen, clasificando las notas según su contenido semántico y el título del destino. La decisión de mover una nota se toma de forma automática solo cuando hay una única subpágina con un ajuste semántico fuerte, los límites de la nota están claros y no se requiere reescritura o fusión; en todos los demás casos (incluyendo la creación de nuevas subpáginas) se presenta al usuario las opciones y se espera su decisión. Finalmente, ejecuta los movimientos en lotes, verifica su integridad y reporta un resumen de las acciones realizadas, las aprobadas por el usuario, las páginas creadas y las ambigüedades pendientes.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/goromal/agent-skills/tree/HEAD/skills/itns-notes

Installed? Explore more Productividad y colaboración skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Process ITNS notes

Use the installed Notion MCP server. Preserve each note's wording, formatting, links, dates, priority markers, block types, order, and nested children. Do not summarize, rewrite, split, merge, deduplicate, or delete content unless the user explicitly asks.

Resolve the source page

  1. Match the user-provided page name exactly and case-insensitively against the first column of ~/configs/goromail-categories.csv.
  2. Use the corresponding second-column Notion page ID.
  3. Stop and ask if there is no exact match or more than one exact match. Never guess an ID from a similar name.

Discover notes and destinations

  1. Call notion_list_subpages on the source page to collect candidate destinations.
  2. Call notion_list_blocks with recursive: true on the source page. Treat a parent block and all descendants as one indivisible note tree.
  3. Treat adjacent top-level paragraphs, list items, code blocks, and other prose as one compound note when their content clearly forms a continuous thought. If its boundary is uncertain, classify the boundary as ambiguous and ask the user.
  4. Exclude headings, child-page blocks, page-mention links, and other navigation or structural blocks. When a Repository heading exists, use the loose content after it as the source-note region. If no reliable source-note boundary exists, ask before moving anything.
  5. Inspect relevant destination contents with recursive block listing. Classify from both the destination title and its existing subject matter, not its title alone.
  6. For an opaque link or vague label, inspect the linked material when access is available. Ask rather than infer when its subject remains unclear.

Decide automatically or ask

Move a note automatically only when all of these are true:

  • exactly one existing subpage is a strong semantic fit;
  • the complete note and its boundaries are understood;
  • the move requires no rewriting, splitting, merging, or category invention.

Treat every other case as ambiguous. Present the complete note or a faithful compact preview, the plausible destinations, and one recommendation with a short reason. Wait for the user's decision before writing that note. Always ask before creating or naming a new subpage.

Continue processing independent obvious notes while ambiguous notes await a decision. Do not let an obvious placement silently decide a related ambiguous placement.

Execute and verify moves

  • Move one top-level note tree with notion_move_block; its descendants move with it.
  • Move a compound note made of adjacent top-level blocks with notion_move_blocks. Pass block IDs once, in their original order, to one destination.
  • Create a user-approved category with notion_create_subpage, then move only the notes approved for it.
  • Never emulate a move with lossy text append plus deletion.
  • After each batch, list the source and destination again. Verify that every source block is absent, every destination block is present in order, child counts match, and block types and text are preserved.
  • If any operation partially fails, stop further writes, inspect both pages, and report the exact copied, archived, remaining, or duplicated blocks before attempting repair.
  • If recursive listing or ordered batch moves are unavailable, stop and report that the Notion MCP server must be deployed or upgraded before compound notes can be processed safely.

Finish with a concise record of automatic moves, user-approved moves, created pages, deferred ambiguities, and verification results.

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

Skills relacionados