forge-compétence

SkillForge

Créez des compétences bien formées et conformes aux spécifications à partir de motifs observés.

Quand forger

✅ Forgez quand :

• Vous avez effectué la même séquence 2 à 3 fois dans une session
• Une convention de projet n'est documentée nulle part
• Vous avez résolu un problème difficile avec une solution réutilisable
• Quelqu'un vous demande de créer une compétence

❌ Ne forgez pas quand :

• C'est une tâche unique
• Une compétence existante la couvre déjà (mettez-la à jour à la place)
• La « compétence » n'est qu'une simple commande (utilisez un alias de script)

Étapes

1. Nommez le motif

• Quel problème cette compétence résout-elle ?
• Qu'est-ce qui la déclenche ? (soyez précis — le champ description est la surface de découverte)
• Quelles sont les entrées et les sorties ?

2. Choisissez un nom

• kebab-case, 1 à 64 caractères
• Commencez par un verbe si possible : deploy-preview, scaffold-component, triage-bug
• Une responsabilité par compétence

3. Créez le répertoire de la compétence

mkdir -p skills/<skill-name>

4. Rédigez SKILL.md

Utilisez ce squelette :

---
name: <skill-name>
description: <ce qu'elle fait>. À utiliser quand <déclencheurs>.
metadata:
  forged-by: <id-agent>
  forged-from: <session-ou-contexte>
  forged-reason: "<pourquoi cela a été créé>"
---

# <Nom de la compétence>

## Entrées
- ...

## Étapes
1. ...
2. ...

## Conventions
- Motifs spécifiques au projet qui s'appliquent

## Cas limites
- Pièges connus ou gestion spéciale

5. Ajoutez des scripts (optionnel)

Si la compétence implique la génération de fichiers ou de l'automatisation :

skills/<skill-name>/
├── SKILL.md
├── scripts/
│   └── run.sh         # Automatisation exécutable
└── references/
    └── conventions.md # Référence détaillée (garde SKILL.md léger)

6. Enregistrez la compétence

Mettez à jour .skills-registry.md à la racine du projet (au même niveau que skills/). Créez-le s'il n'existe pas :

| <skill-name> | local | <today> | 1 | <description> |

Si le projet utilise le registre lisible par machine (.skills-registry.json), mettez-le à jour aussi — skdd forge gère les deux formats automatiquement.

Mise à jour d'une compétence existante

Lorsque vous utilisez une compétence et rencontrez quelque chose qu'elle ne couvre pas :

1. Ajoutez le nouveau cas limite ou étape au SKILL.md existant
2. Si la compétence devient trop longue (>200 lignes), divisez-la
3. Mettez à jour last-used et incrémentez usage-count dans le registre

Liste de contrôle qualité

Avant de valider une nouvelle compétence :

• name est en kebab-case, ≤64 caractères
• description inclut ce qu'elle fait ET quand l'utiliser
• Les étapes sont numérotées et actionnables
• Aucun chemin codé en dur, secret ou valeur spécifique à l'environnement
• SKILL.md fait moins de 200 lignes (déplacez les détails dans references/)
• Enregistré dans .skills-registry.md