Maintain Docs — Documentation skill for Claude Code

maintain-docs

Skill Claude Code / Cowork pour **maintenir une documentation projet modulaire et économe en tokens**.

Il s'active dès qu'on demande de mettre à jour, éditer ou compléter la doc d'un projet (`CLAUDE.md`, fichiers sous `docs/`) — en français comme en anglais.

Ce que fait le skill

• Édition chirurgicale : cible la bonne section du bon fichier via str_replace, au lieu de régénérer un fichier entier (l'output coûte ~5× l'input).
• Routage par thème : une info de test va dans docs/testing.md, un point deploy dans docs/deploy.md — jamais tout empilé dans CLAUDE.md.
• Discipline sur les @import : ce qui est auto-chargé à chaque session reste petit et evergreen ; le reste est en référence simple, lu à la demande.
• Section « Où on en est » : mise à jour du statut projet par remplacement du seul paragraphe concerné.

Structure de doc visée

Fichier	Chargement	Rôle
CLAUDE.md	@import	Point d'entrée court, statut projet
docs/architecture.md	@import	Architecture evergreen
docs/conventions.md	@import	Conventions de code
docs/journal.md, product.md, testing.md, deploy.md, extension.md	référence simple	Lus à la demande

Installation

Claude Code

git clone https://github.com/Shedzo/maintain-docs.git ~/.claude/skills/maintain-docs

Ou, pour un seul projet :

git clone https://github.com/Shedzo/maintain-docs.git .claude/skills/maintain-docs

Le skill est ensuite détecté automatiquement au démarrage de la session.

Cowork / claude.ai

Uploader `SKILL.md` dans les paramètres de skills de votre compte.

Utilisation

Aucune commande à retenir — le skill se déclenche tout seul sur des demandes du type :

• « mets à jour le CLAUDE.md »
• « documente ça »
• « ajoute une section sur X dans la doc »
• « update the docs »

Licence

MIT — voir [LICENSE](LICENSE).