goromal/agent-skills

Intégrer, trier, organiser ou acheminer des notes ITNS (« Intégrer Ces Notes Quelque Part ») d'une page Notion nommée vers les sous-pages appropriées.

Qu'est-ce que agent-skills ?

Ce skill permet à un agent IA d'automatiser le traitement des notes non classées (ITNS) dans Notion. Il résout la page source à l'aide d'un fichier CSV de catégories, découvre les notes et leurs destinations en inspectant les sous-pages et blocs enfants, puis décide automatiquement de déplacer une note ou demande une décision à l'utilisateur en cas d'ambiguïté. Pour garantir l'intégrité des données, le skill préserve le texte, la mise en forme, les liens, les dates et la structure des notes sans les résumer, réécrire, fusionner ou dédupliquer. Il prend en charge les serveurs MCP Notion, les blocs composés (paragraphes, listes, code) et vérifie chaque déplacement via une vérification de cohérence après exécution. Idéal pour les utilisateurs qui souhaitent maintenir une base de connaissances Notion organisée sans effort manuel.

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

Installed? Explore more Productivité et collaboration skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Traiter les notes ITNS

Utiliser le serveur MCP Notion installé. Conserver le libellé, le formatage, les liens, les dates, les indicateurs de priorité, les types de blocs, l'ordre et les enfants imbriqués de chaque note. Ne pas résumer, réécrire, fractionner, fusionner, dédupliquer ni supprimer le contenu, sauf demande explicite de l'utilisateur.

Résoudre la page source

  1. Faire correspondre le nom de la page fourni par l'utilisateur exactement et sans tenir compte de la casse avec la première colonne de ~/configs/goromail-categories.csv.
  2. Utiliser l'ID de page Notion correspondant dans la deuxième colonne.
  3. S'arrêter et demander s'il n'y a pas de correspondance exacte ou plus d'une correspondance exacte. Ne jamais deviner un ID à partir d'un nom similaire.

Découvrir les notes et les destinations

  1. Appeler notion_list_subpages sur la page source pour collecter les destinations candidates.
  2. Appeler notion_list_blocks avec recursive: true sur la page source. Traiter un bloc parent et tous ses descendants comme un arbre de notes indivisible.
  3. Traiter les paragraphes, éléments de liste, blocs de code et autres textes adjacents de premier niveau comme une seule note composée lorsque leur forme clairement une pensée continue. Si sa limite est incertaine, classer la limite comme ambiguë et demander à l'utilisateur.
  4. Exclure les titres, les blocs de sous-page, les liens de mention de page et autres blocs de navigation ou structurels. Lorsqu'un titre Repository existe, utiliser le contenu libre après lui comme zone de note source. Si aucune limite fiable de note source n'existe, demander avant de déplacer quoi que ce soit.
  5. Inspecter le contenu pertinent de la destination avec un listage récursif de blocs. Classer à la fois à partir du titre de la destination et de son contenu existant, pas seulement de son titre.
  6. Pour un lien opaque ou une étiquette vague, inspecter le matériau lié lorsque l'accès est disponible. Demander plutôt que d'inférer lorsque son sujet reste flou.

Décider automatiquement ou demander

Ne déplacer une note automatiquement que lorsque toutes ces conditions sont remplies :

  • exactement une sous-page existante est une correspondance sémantique forte ;
  • la note complète et ses limites sont comprises ;
  • le déplacement ne nécessite aucune réécriture, fractionnement, fusion ou invention de catégorie.

Traiter tout autre cas comme ambigu. Présenter la note complète ou un aperçu compact fidèle, les destinations plausibles, et une recommandation avec une brève justification. Attendre la décision de l'utilisateur avant d'écrire cette note. Toujours demander avant de créer ou de nommer une nouvelle sous-page.

Continuer à traiter les notes évidentes indépendantes pendant que les notes ambiguës attendent une décision. Ne pas laisser un placement évident décider silencieusement d'un placement ambigu connexe.

Exécuter et vérifier les déplacements

  • Déplacer un arbre de notes de premier niveau avec notion_move_block ; ses descendants se déplacent avec lui.
  • Déplacer une note composée de blocs adjacents de premier niveau avec notion_move_blocks. Passer les ID de bloc une fois, dans leur ordre d'origine, vers une destination.
  • Créer une catégorie approuvée par l'utilisateur avec notion_create_subpage, puis déplacer uniquement les notes approuvées pour celle-ci.
  • Ne jamais émuler un déplacement avec un ajout de texte avec perte et une suppression.
  • Après chaque lot, lister à nouveau la source et la destination. Vérifier que chaque bloc source est absent, chaque bloc destination est présent dans l'ordre, les comptes d'enfants correspondent, et les types de blocs et le texte sont préservés.
  • En cas d'échec partiel d'une opération, arrêter les écritures ultérieures, inspecter les deux pages et signaler exactement les blocs copiés, archivés, restants ou dupliqués avant de tenter une réparation.
  • Si le listage récursif ou les déplacements par lots ordonnés ne sont pas disponibles, s'arrêter et signaler que le serveur MCP Notion doit être déployé ou mis à niveau avant que les notes composées puissent être traitées en toute sécurité.

Terminer par un enregistrement concis des déplacements automatiques, des déplacements approuvés par l'utilisateur, des pages créées, des ambiguïtés différées et des résultats de vérification.

Individual skills in this repo

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

Skills associés