agentleFS
enzobleuzeenzobleuze/machine-claude/.claude/skills/lint-wiki/SKILL.md

lint-wiki

Skill2 starsChanged 20 days agoMITView on GitHub

Installe le bilan de santé du wiki (liens morts, orphelines, pages maigres, frontmatter, moins de 3 liens, index désynchronisé) et la règle : Claude répare lui-même l'hygiène technique. Utiliser quand l'utilisateur dit « audit du wiki », « lint », « vérifie la santé du wiki », « /lint ». Pas pour vérifier le moteur de recherche (utiliser recherche-par-le-sens) ni pour l'entretien de nuit (utiliser jardinier).

2 other projects use a version of this.

Adopted by

Most recently taken up by

The file

Files
SKILL.md

Bilan de santé du wiki (lint)

Pourquoi

Dans le système d'origine, une notification a annoncé un jour plus d'un millier de liens morts. Claude a demandé au fondateur s'il fallait créer les pages ou retirer les liens. Réponse : « le wiki, c'est toi qui l'écris ; si il y a des erreurs, c'est toi qui sais comment réparer ». Depuis, le bilan sépare deux choses : l'hygiène technique (liens, frontmatter, index), que Claude répare seul avec une règle sûre, et les vraies questions de fond (deux pages qui se contredisent), seules soumises à la personne.

Prérequis

  • architecture-vault fait. Python 3.9+. Aucun coût.

Interview

Lis d'abord : wiki/maps/architecture.md (zones privées), le dernier bilan dans outputs/lint/ s'il existe.

Puis demande une seule chose : « Tu veux voir le bilan à chaque fois, ou seulement quand il y a une contradiction de fond à trancher ? » Défaut : seulement les contradictions. Range la réponse dans wiki/maps/lint.md.

Construire

  1. Outil (2 min). Copie outils/lint_wiki.py vers scripts/lint_wiki.py (le nom avec tiret bas compte : le jardinier l'importe). Vérifie : python scripts/lint_wiki.py --test puis python scripts/lint_wiki.py.
  2. Règles de réparation (5 min). Écris dans wiki/maps/lint.md les règles que Claude applique sans demander :
    • lien mort vers une page qui existe sous un nom proche : corriger le lien ;
    • lien mort vers un concept qui revient dans plusieurs pages : créer la page (frontmatter, 3 liens, contenu tiré des pages qui en parlent) ;
    • lien mort isolé sans valeur : retirer les crochets, garder le texte ;
    • orpheline : l'ajouter à la carte ou au _index.md de son dossier ;
    • moins de 3 liens : ajouter des liens vers des pages vraiment proches (cherche avec /cerveau) ;
    • frontmatter incomplet : le jardinier complète la nuit, sinon compléter ;
    • page maigre : enrichir depuis raw/ ou fusionner avec la page voisine (archiver l'ancienne, jamais supprimer). Plafond de sécurité : au-delà de 100 réparations d'un coup, faire un commit avant et un après.
  3. La commande (5 min). .claude/commands/lint.md :
    ---
    description: "Bilan de santé du wiki et réparations sûres. Utiliser quand on dit « audit du wiki », « lint », « /lint »."
    ---
    1. `python scripts/lint_wiki.py --json > outputs/lint/AAAA-MM-JJ.json` (crée le dossier).
    2. Applique les règles de wiki/maps/lint.md, sans demander. Commit avant si plus de 100 changements.
    3. Contradictions : relis les principes qui parlent du même sujet ; si deux pages se contredisent,
       montre les deux phrases et demande laquelle garder. C'est la seule question posée.
    4. Relance `python scripts/lint_wiki.py` et donne : avant, après, ce qui reste.
    5. Entrée dans log.md.
  4. Route (1 min). Ligne « audit du wiki » dans wiki/maps/routage.md.
  5. Premier passage (10 à 20 min). Lance /lint, montre le avant et après.

Test

Après /lint : python scripts/lint_wiki.py --strict sort le code 0 (aucun lien mort), et le nombre d'orphelines a baissé. Le hook des 3 liens reste silencieux sur les pages réparées.

Pièges vécus

  • Demander à la personne de trancher une erreur technique de Claude : perte de temps et de confiance. Elle ne voit que les contradictions de fond.
  • Liens morts en boule de neige : une page renommée casse des dizaines de liens. Obsidian met à jour les liens s'il fait le renommage ; quand Claude renomme, il corrige les liens dans la même opération.
  • Réparation de masse sans commit : impossible à défaire proprement. Commit avant, commit après.
  • Liens écrits à l'intérieur de blocs de code comptés comme des liens : l'outil ignore le code.

Entretien dans le temps

Le jardinier compte les liens morts et orphelines chaque nuit et les met dans son résumé. Un /lint complet une fois par semaine (ou quand le résumé montre une hausse). Une notification seulement si le nombre augmente d'une semaine à l'autre.

Après

Coche la ligne lint-wiki dans wiki/maps/parcours.md, entrée dans log.md, puis propose jardinier.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.