BorjaGM1/kb-template

Lint et nettoie les coffrets (liens brisés, orphelins, doublons, notes obsolètes, tags, MOCs) et produit un rapport. Les suppressions nécessitent l'accord du propriétaire.

Qu'est-ce que kb-template ?

Cette compétence pour agents IA spécialisée dans la gestion de coffrets de notes (vaults) en Markdown permet d'effectuer un nettoyage complet et structuré. Elle vérifie l'intégrité des liens, identifie les notes orphelines ou en double, repère les notes obsolètes, normalise les tags et la métadonnée frontmatter, et assure la cohérence des MOCs (Maps of Content). L'agent exécute un script de lint, puis propose des corrections sans jamais supprimer de fichier sans l'approbation explicite du propriétaire. Chaque modification est regroupée en commits logiques et un rapport détaillé est fourni. Compatible avec tout environnement utilisant Git et Python, cette compétence est idéale pour les utilisateurs de systèmes de prise de notes comme Obsidian, Foam ou tout coffret Markdown versionné.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/BorjaGM1/kb-template/tree/HEAD/skills/gardening

Installed? Explore more Développement et programmation skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · 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

Jardinage

  1. Depuis la racine du dépôt : git pull --rebase.
  2. Exécute python3 scripts/lint.py (tous les coffrets) et collecte la sortie.
  3. Liens brisés : corrige les fautes de frappe/renommages en pointant vers la note existante ; si la cible est réellement manquante, crée une note squelette uniquement si utile, sinon supprime le lien. Ne jamais inventer de contenu.
  4. Orphelins : lie chaque orphelin depuis une note associée ou un MOC ; si cela ne convient pas, déplace-le dans Inbox/.
  5. Doublons : trouve les titres/alias/contenus similaires (rg, compare). Fusionne dans la meilleure note (conserve tous les faits, union des sources, ajoute un alias, redirige les liens). Les fusions qui suppriment du contenu ou des fichiers : propose, ne fais pas.
  6. Notes obsolètes : updated > 6 mois, squelettes vides, projets terminés : propose status: archiver ou suppression.
  7. Tags : normalise la casse/kebab-case, fusionne les synonymes (#idées en #idée), supprime les tags uniques sans intérêt.
  8. Frontmatter : assure que created/updated/source/tags sont présents et valides.
  9. Boîte de réception : classe les notes de Inbox/ au bon endroit quand c'est clair.
  10. MOCs : maintient Home.md et les MOCs thématiques à jour ; crée un MOC lorsqu'un sujet atteint environ 5 notes.
  11. Relance le lint ; commit par changement logique (jardin(<v>): ...) ; pousse immédiatement après chaque commit.
  12. Rapport au propriétaire : ce qui a été corrigé, ainsi que les suppressions/fusions/archives proposées nécessitant approbation. Ne jamais supprimer sans l'accord du propriétaire.

Individual skills in this repo

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

Skills associés