skill-architect

Le skill unique pour creer, tester, documenter, publier et deprecier des skills. 9 phases, 3 paths, 13 anti-patterns.

Le seul skill dont tu as besoin pour gerer tout le lifecycle d'un skill. De l'idee a la production a la retraite.

Declencheurs

"cree un skill" / "create skill"
"skill-architect"
"ameliore ce skill" / "improve this skill"
"teste mon skill" / "test my skill"
"publie ce skill" / "publish skill"
"deprecie ce skill"

Les 9 phases

DISCOVER → SPECIFY → CREATE → TEST → REVIEW → ITERATE → DOCUMENT → PUBLISH → EVOLVE

Phase	Action	Reference
Discover	Verifie que le skill n'existe pas deja	Decouvrir
Specify	Definit l'intent en 4 questions ecrites	Lifecycle
Create	Ecrit le SKILL.md avec le template	Ecrire
Test	TDD : baseline → with-skill → pressure	Tester
Review	Score dual-axis, gate 90+	Tester
Iterate	Boucle 3-agents jusqu'a convergence	Iterer
Document	Onboarding, reference, FAQ	Lifecycle
Publish	Install sur 8 plateformes	Lifecycle
Evolve	Semver, changelog, deprecation	Evoluer

3 paths selon le contexte

FAST PATH (5 min) — Skills simples

1. DISCOVER  → grep + search (2 min)
2. CREATE    → SKILL.md depuis template (2 min)
3. VALIDATE  → quick_validate + description shortcut test (1 min)
4. INSTALL   → Copier dans le bon dossier

FULL PATH (30 min) — Skills production

1. DISCOVER  → Filesystem + KB + registre web
2. SPECIFY   → 4 questions d'intent ecrites
3. CREATE    → SKILL.md + references/
4. TEST      → 3 configs x 3 runs
5. REVIEW    → Score dual-axis, gate 90+
6. ITERATE   → Boucle 3-agents (self-improve)
7. DOCUMENT  → Onboarding + FAQ
8. PUBLISH   → Cross-platform + KB-SYNC
9. EVOLVE    → Semver + changelog

EVOLVE PATH — Skills existants

1. READ      → SKILL.md actuel + usage recent
2. DIAGNOSE  → Score, trigger accuracy, gaps
3. MUTATE    → Version A (conservatrice) + Version B (radicale)
4. TEST      → Blind comparison, 3x3 runs
5. MERGE     → Le gagnant est applique, version bumped

Les 4 regles d'or

La description est le point de defaillance #1. Corrige-la en premier.
Chaque etape produit un artefact. Si tu ne peux pas le montrer, tu as saute l'etape.
Un skill a 89 n'est pas pret. Le seuil est 90.
1 run = bruit. 3 runs = signal. Toujours 3.

Structure de fichiers

mon-skill/
├── SKILL.md              # Fichier principal (max 500 lignes)
├── references/           # Docs de debordement (1 niveau)
├── scripts/              # Automatisation (validate, benchmark)
├── tests/                # Fixtures et evals
└── assets/               # Templates, configs

Exemple d'utilisation complet

Toi : "cree un skill pour auditer la securite des APIs"

skill-architect :

1. DISCOVER → grep "security" "api" "audit" dans ~/.claude/skills/
   → Trouve api-security-best-practices (partiel), pas d'audit complet → creer

2. SPECIFY →
   - Permet : auditer les endpoints API contre OWASP Top 10
   - Trigger : "audit API", "security review", "check OWASP"
   - Output : rapport avec score + violations + fixes
   - Edge cases : GraphQL, WebSocket, gRPC

3. CREATE → SKILL.md avec template body, 280 lignes

4. TEST →
   - Normal : audit sur 3 APIs fictives → OK
   - Pressured : audit rapide en 2 min → rate 2 checks
   - Without-skill : l'agent fait un audit generique → 40% moins complet
   - Score : 87/100

5. REVIEW → Gate 90 non atteint → ITERATE

6. ITERATE →
   - Brainstormer : ajoute checks GraphQL + rate limiting
   - Builder : teste sur API reelle → 2 gaps
   - Critic : 92/100 → PASS

7. DOCUMENT → Onboarding (2 min), reference (tous les checks)
8. PUBLISH → ~/.claude/skills/api-security-auditor/
9. EVOLVE → v1.0.0, changelog cree

Plateformes supportees

Plateforme	Chemin
Claude Code	`~/.claude/skills/`
Cursor	`.cursor/rules/`
GitHub Copilot	`.github/skills/`
Codex CLI	`~/.agents/skills/`
Gemini CLI	`~/.gemini/skills/`
Windsurf	`.windsurf/rules/`
Cline	`.clinerules/`
Kiro	`.kiro/skills/`

Fichier source

~/.claude/skills/skill-architect/
├── SKILL.md (126 lignes)
└── references/ (10 fichiers, 439 lignes)

Lecture liee

Lifecycle des skills — les 9 phases en detail
Ecrire un skill — template, description CSO, limites
Tester un skill — TDD, 3x3, grader independant
Anti-patterns — les 13 pieges a eviter

skill-architect

On this page