| name | doc-as-code |
| description | Utiliser Typedoc/Sphinx et maintenir README/CONTRIBUTING. Use this skill whenever the user asks about doc as code in an open-source maintenance context — including phrasing like "générer la documentation", "mettre à jour le readme", "maintenir la doc à jour" — even if they don't name the skill directly. |
| version | 1.0.0 |
| pilier | technical_excellence |
| triggers | ["générer la documentation","mettre à jour le readme","maintenir la doc à jour"] |
| compatibility | IA-agnostique (Claude, GPT, Gemini, Copilot, ou lecture humaine directe) — aucune dépendance à un vendor. |
Quand invoquer ce skill
Utiliser Typedoc/Sphinx et maintenir README/CONTRIBUTING.
L1 — Réflexe de base
Maintenir un README à jour avec install, usage, licence.
L2 — Pratique professionnelle par défaut
Générer la doc API depuis les commentaires du code (Typedoc/Sphinx/JSDoc) pour qu'elle ne diverge jamais du code.
L3 — Maîtrise d'architecte
Documentation versionnée en parallèle des releases, CONTRIBUTING.md incluant le workflow de rebase/PR attendu, CI qui échoue si la doc publique n'est pas régénérée.
