doc-as-code

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.