Comment créer une custom skill

mai 5, 2026

J’ai créé la skill article-writing pour transformer des conversations CLI en articles markdown publiables. La V1 était surtout orientée Codex, puis j’ai itéré : extraction plus générique, livrables plus propres, et 4 tones/voices.

Voici une méthode reproductible pour créer une custom skill.

Prérequis#

Avoir un outil CLI comme claude code, copilot, codex ou autres et un fichier SKILL.md pour décrire votre skill.

SKILLS/<skill-name>/SKILL.md

Exemple :

SKILLS/article-writing/SKILL.md

How-to#

1) Définir le scope#

Définir le comportement de la skill en une phrase complète :

ce qu’elle prend en entrée,
ce qu’elle fait,
ce qu’elle produit.

Exemple :

Entrée : une conversation CLI brute.
Action : extraire les messages utiles puis les structurer.
Sortie : un article markdown publiable.

2) Écrire le frontmatter minimal#

---
name: article-writing
description: Convertit une conversation agentique en article markdown publiable.
---

3) Construire un workflow exécutable#

## Workflow
1. Identifier l’entrée
2. Extraire les données utiles
3. Vérifier le résultat intermédiaire
4. Demander les paramètres nécessaires
5. Générer le livrable final

4) Itérer par petites modifications#

Boucle simple :

Modifier un point
Tester sur un cas réel
Vérifier qu’il n’y a pas de régression

Exemple réel :

V1 : flux initial
V2 : extraction plus générique
V3 : livrables + tones/voices

5) Invoquer la skill#

Tu as deux modes utiles.

Invocation explicite (recommandée au début) :

@SKILLS/article-writing/SKILL.md

Ici, tu forces l’usage de cette skill précise.

Invocation par intention (quand la skill est déjà bien décrite) :

Écris un article à partir de notre conversation précédente.

Dans ce cas, l’agent sélectionne la skill si la description et les triggers de SKILL.md correspondent.

Contrôle pratique : si la réponse ne suit pas le workflow attendu, ré-invoque explicitement la skill via le chemin @SKILLS/.../SKILL.md.

Resources#

Skill article-writing dispo ici: SKILL.md