BorjaGM1/kb-template

Transforme le contenu envoyé par le propriétaire (texte, lien, transcription vocale, capture d’écran) en une note bien structurée et liée dans le bon coffre.

Qu'est-ce que kb-template ?

Capture est une compétence d’agent IA qui permet de transformer automatiquement tout élément envoyé par l’utilisateur (texte, lien, transcription vocale, capture d’écran, fil de discussion long) en une note bien formatée, liée et rangée dans le coffre de connaissances approprié. Elle est conçue pour fonctionner avec n’importe quel agent orienté fichiers comme Claude Code, Cursor ou Codex, et s’appuie sur une structure de dossiers et de fichiers précise (AGENTS.md, scripts, coffres). Le processus suit plusieurs étapes : extraction du contenu, sélection du coffre, recherche de notes existantes pour éviter les doublons, création ou mise à jour de la note avec wikiliens et MOC, respect de la grammaire et des tags en anglais, et linting avant commit. La compétence insiste particulièrement sur l’intégrité de l’information (ne jamais inventer, marquer les inférences) et la couverture complète des longs fils de discussion.

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

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

Capture

  1. Depuis la racine du dépôt : git pull --rebase.
  2. Vérifier le périmètre (AGENTS.md) : envoyé explicitement ? Pas un sujet exclu ? Retirer les secrets éventuels.
  3. Extraire le contenu :
    • Texte : utiliser tel quel, améliorer le style, garder le sens.
    • Lien : récupérer la page ; noter le titre, l’auteur, la date, 3 à 7 points clés, l’URL dans source.
    • Voix : transcrire ; conserver l’intention du propriétaire ; supprimer les mots de remplissage.
    • Longs fils (X, forums) : lire les réponses en texte intégral, pas des extraits tronqués, et au‑delà de la première page. Sur les fils énormes, couvrir la partie substantielle (réponses de l’auteur, réponses à fort signal). Indiquer la couverture dans la note (ex. « lu 40 des 55 réponses de l’auteur »).
    • Capture d’écran / image : décrire/OCR le texte pertinent ; stocker l’image dans attachments/ si utile.
  4. Choisir le coffre (tableau dans AGENTS.md). En cas de doute : coffre par défaut Inbox/ + une question au propriétaire.
  5. Rechercher les notes existantes sur le même sujet (rg -il "<mots-clés>" vaults/<v>). Privilégier la mise à jour d’une note existante (incrémenter updated) plutôt que la création d’un doublon.
  6. Si nouvelle note : une note atomique par idée ; fractionner si l’entrée couvre plusieurs sujets. Nom de fichier selon AGENTS.md ; frontmatter created/updated/source/tags ; contenu et tags en anglais.
  7. La lier : au moins un [[lien]] vers une note connexe ou un MOC, et l’ajouter au MOC concerné (ou à Home.md). Non triée : Inbox/.
  8. Ne jamais inventer ; marquer les inférences.
  9. Relecture avant commit : relire la/les note(s) rédigée(s) à côté des notes liées/connexes et des tags existants du coffre (rg -h '^tags:' vaults/<v> | tr -d '[]' | tr ',' '\n' | sed 's/^ *//' | sort -u). Vérifier et corriger :
    • Le corps et les tags sont en anglais.
    • Les tags correspondent au sujet et sont cohérents avec les notes sœurs/liées.
    • Réutiliser les tags existants avant d’en inventer de nouveaux.
    • Les wikiliens et les entrées MOC / Home.md sont complets.
    • Aucun fait inventé ; les inférences sont marquées.
  10. python3 scripts/lint.py vaults/<v> ; committer capture(<v>): <titre> ; pousser immédiatement.
  11. Répondre brièvement avec la/les note(s) créée(s)/mise(s) à jour.

Individual skills in this repo

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

Skills associés