Créer une Skill

Créez une nouvelle skill dans .agents/skills/<skill-name>/ en suivant le workflow défini dans .agents/skills/README.md.

Workflow

Étape 1 : Recueillir l'intention

Avant de créer quoi que ce soit, posez à l'utilisateur les questions suivantes :

1. Nom de la skill : Comment la skill doit-elle s'appeler ? (minuscules, chiffres, tirets uniquement, ex. gh-create-pr, prepare-release)
2. Description : Que doit faire cette skill ? Incluez les contextes de déclenchement spécifiques (ex. « Utiliser quand l'utilisateur demande de créer des PR »)
3. Est-ce une skill publique ? : Doit-elle être synchronisée vers .claude/skills/ pour un usage partagé ? (par défaut : non, privée uniquement)
4. Cas de test (optionnel) : L'utilisateur souhaite-t-il configurer des evals pour cette skill ?

Si l'utilisateur fournit des informations partielles (ex. juste un nom), continuez avec des valeurs par défaut raisonnables et demandez une confirmation.

Étape 2 : Lire les directives

Lisez toujours .agents/skills/README.md avant de créer une nouvelle skill pour assurer la conformité avec le workflow actuel.

Étape 3 : Créer la structure de la skill

Créez la structure de répertoire suivante :

.agents/skills/<skill-name>/
└── SKILL.md

Modèle SKILL.md :

---
name: <skill-name>
description: <description>
---

# <Skill Name>

[Instructions pour la skill]

Champs frontmatter :

• name : Identifiant de la skill (minuscules, chiffres, tirets)
• description : Quand déclencher (ce que fait la skill + contextes spécifiques)

Étape 4 : Synchroniser (si publique)

Si l'utilisateur souhaite une skill publique, avant validation :

1. Ajoutez le nom de la skill à .agents/skills/public-skills.txt (une par ligne, pas de commentaires en ligne)
2. Exécutez la synchronisation :

   pnpm skills:sync

Cela crée un symlink à .claude/skills/<skill-name>/ pointant vers .agents/skills/<skill-name>/.

Note : pnpm skills:check valide principalement les skills publiques (celles dans public-skills.txt) et vérifie aussi les fichiers de gouvernance associés, donc vous devez synchroniser en premier avant de valider.

Étape 5 : Valider

Exécutez la commande de validation :

pnpm skills:check

S'il y a des problèmes, corrigez-les et réexécutez.

Étape 6 : Résumé

Présentez à l'utilisateur :

• Fichiers créés
• Résultat de la validation
• Étapes suivantes (comment utiliser la skill)

Règles de nommage

• Utilisez uniquement des lettres minuscules, des chiffres et des tirets
• Préférez les noms courts et orientés action (ex. gh-create-pr)

Skills publiques vs privées

Référence des commandes

# Valider la structure de la skill
pnpm skills:check

# Synchroniser les skills publiques vers Claude
pnpm skills:sync

Contraintes

• Ne créez jamais de skills en dehors de .agents/skills/<skill-name>/
• Toujours exécuter pnpm skills:check avant de terminer
• Les skills publiques nécessitent à la fois l'ajout à public-skills.txt ET l'exécution de pnpm skills:sync
• Si la skill skill-creator est disponible, vous pouvez l'utiliser pour le développement avancé de skills (evals, itérations), mais cette skill gère le workflow de création basique.