Lifecycle complet des skills

Les 9 phases du cycle de vie d'un skill : discover, specify, create, test, review, iterate, document, publish, evolve.

Chaque skill passe par 9 phases, de l'idee a la production. Trois chemins existent selon le contexte : rapide, complet, ou evolution.

Les 9 phases

DISCOVER --> SPECIFY --> CREATE --> TEST --> REVIEW --> ITERATE --> DOCUMENT --> PUBLISH --> EVOLVE
    |                                    |         |
    |         score < 90 ? --------------.         |
    |                                              |
    .-- skill existe ? --> EVOLVE instead ---------'

#	Phase	Action	Artefact produit
1	Discover	Verifier qu'un skill equivalent n'existe pas	Rapport de deduplication
2	Specify	Definir l'intention en 4 questions	Fiche d'intention
3	Create	Ecrire le `SKILL.md` depuis le template	Fichier SKILL.md
4	Test	TDD : baseline, avec-skill, pression	Rapport de tests (3x3)
5	Review	Scoring dual-axis (deterministe + LLM)	Score sur 100
6	Iterate	Boucle 3-agents jusqu'a score cible	Versions ameliorees
7	Document	Ecrire la doc utilisateur	Onboarding, exemples, FAQ
8	Publish	Installer sur les plateformes cibles	Skill deploye
9	Evolve	Versionner, deprecier, retirer	Changelog, semver

FAST PATH -- 5 minutes

Pour les skills simples et a faible risque.

1. DISCOVER  --> grep + search (2 min)
2. CREATE    --> SKILL.md depuis le template (2 min)
3. VALIDATE  --> quick_validate.py + test description (1 min)
4. INSTALL   --> Copier dans le path de la plateforme

Tu utilises le FAST PATH quand le skill est petit, le domaine connu, et le risque faible.

FULL PATH -- 30 minutes

Pour les skills de production qui doivent etre robustes.

1. DISCOVER  --> Triple check : filesystem + KB + registre externe
2. SPECIFY   --> 4 questions d'intention ecrites
3. CREATE    --> SKILL.md + references/ depuis les templates
4. TEST      --> TDD : baseline, avec-skill, pression (3 configs x 3 runs)
5. REVIEW    --> Scoring dual-axis (deterministe + LLM), gate 90+
6. ITERATE   --> Boucle 3-agents (Brainstormer, Builder, Critic) jusqu'a score >= 9
7. DOCUMENT  --> Doc utilisateur : onboarding, exemples, FAQ
8. PUBLISH   --> Installation cross-platform + KB-SYNC + registre equipe
9. EVOLVE    --> Semver, changelog, protocole de deprecation

EVOLVE PATH -- skill existant

Pour ameliorer un skill deja en production.

1. READ      --> Lire le SKILL.md actuel + usage recent
2. DIAGNOSE  --> Qu'est-ce qui ne va pas ? (score, precision du trigger, gaps)
3. MUTATE    --> Version A (conservatrice) + Version B (radicale)
4. TEST      --> 3 configs x 3 runs, comparaison aveugle
5. REVIEW    --> Scorer les deux, choisir le gagnant
6. MERGE     --> Appliquer le gagnant, bumper la version

Les golden rules

La description est le premier point de defaillance. Commence par la.

Chaque etape produit un artefact. Si tu ne peux pas le montrer, tu as saute l'etape.

Un skill qui score 89 n'est pas pret. Le gate est a 90.

1 run = bruit. 3 runs = signal. Toujours 3.

Structure de fichiers

mon-skill/
  SKILL.md              # Fichier principal (max 500 lignes)
  references/           # Documents de debordement (1 niveau de profondeur)
  scripts/              # Automatisation (validation, benchmark)
  tests/                # Fixtures et evaluations
  assets/               # Templates, configs

Le fichier SKILL.md reste sous 500 lignes. Tout ce qui deborde va dans references/.

Lecture liee

Rediger un skill -- ecrire le SKILL.md, frontmatter, description CSO
Tester un skill -- le cycle TDD applique aux skills
Creer un skill -- format, redaction, et validation rapide