Claude skills : l’anatomie d’une skill, fichier par fichier

Les skills existent depuis octobre 2025. En onze mois de standard ouvert, plus de 70 plateformes ont appris à les lire et un million de skills ont été publiées selon Anthropic. Le 22 octobre 2026, Anthropic a même confié le format à la Linux Foundation.

J’utilise 221 skills. Claude, Codex, OpenCode et Hermes Agent (mon assistant IA) les lisent toutes dans le même dépôt.

Alors un petit rappel ne fait pas de mal. Je reprends ma fiche zone par zone. D’abord la règle, valable pour toutes les skills. Puis la même zone dans devis-mail, une skill qui prépare un brouillon de devis quand un client écrit pour demander un prix.

Utiliser une skill dans Claude Code et sur claude.ai

Dans Claude Code, déposez le dossier dans ~/.claude/skills/ pour vous seul ou dans .claude/skills/ pour un projet. Décrivez ensuite la tâche normalement. Claude ouvre la skill quand votre demande correspond à sa description. Tapez /devis-mail pour l’appeler directement.

Sur claude.ai, la skill s’importe en dossier zippé. L’envoi de vos propres skills demande une offre payante avec l’exécution de code activée.

Depuis sa version 2.1.273, Claude Code copie les skills de votre compte claude.ai dans ~/.claude/skills/synced/. Il suffit d’y être connecté avec ce compte. L’inverse ne marche pas : une skill posée sur votre machine n’apparaît jamais sur claude.ai.

---
name: devis-mail
description: Brouillon de devis quand un mail demande un prix. À utiliser dès qu'un client écrit pour connaître un tarif, une quantité ou un délai.
---

# Devis à partir d'un mail

## Étapes
1. Noter le besoin, la quantité et le délai demandés dans le mail.
2. Comparer à la grille tarifaire : references/grille-tarifaire.md
3. Calculer le total avec scripts/total.py (quantité, prix unitaire).
4. Remplir assets/modele.md, sur le modèle de references/exemple-devis.md

## Si un prix manque
Demander au client, sans rien deviner.
Écrire la question en fin de brouillon et laisser la ligne vide.

# Devis n° {numero}

Client : {client}
Date : {date}
Valable 30 jours.

| Prestation | Quantité | Prix unitaire HT | Total HT |
|---|---|---|---|
| {prestation} | {quantite} | {prix_unitaire} € | {total} € |

Délai de réalisation : {delai}

Questions en attente : {questions}

# Devis n° 2026-038

Client : Garage Lefebvre
Date : 21 octobre 2026
Valable 30 jours.

| Prestation | Quantité | Prix unitaire HT | Total HT |
|---|---|---|---|
| Automatisation n8n simple | 2 | 450 € | 900 € |

Délai de réalisation : sous 15 jours

Questions en attente : aucune

# Grille tarifaire (exemple)

| Prestation | Unité | Prix HT |
|---|---|---|
| Atelier IA d'une demi-journée | atelier | 120 € par participant |
| Automatisation n8n simple | workflow | 450 € |
| Heure de coaching | heure | 90 € |

"""Total d'une ligne de devis : python3 scripts/total.py <quantité> <prix unitaire HT>."""
import sys

quantite, prix = int(sys.argv[1]), float(sys.argv[2])
total = quantite * prix
print(f"{quantite} × {prix:g} € → {total:g} €")

$ python3 scripts/total.py 3 120
3 × 120 € → 360 €

Le test : Codex prépare un devis sans qu’on lui nomme la skill

Le 4 novembre 2026, j’ai donné cette skill à Codex dans un dossier vierge. Je lui ai seulement écrit « Prépare le devis de ce mail ». Dessous, j’ai collé un mail de test : Marc demande 3 places à l’atelier IA sous 3 semaines.

Codex a ouvert devis-mail tout seul. Il a lu la grille, lancé total.py 3 120 et rempli le modèle. Voici le brouillon rendu.

Et dans sa réponse, Codex a ajouté ceci.

Le projet de devis est prêt : 3 places à 120 € HT, soit 360 € HT, avec un délai de réalisation sous 3 semaines.

À faire : attribuer le numéro de devis avant envoi.
Confiance : élevée sur le tarif et le total, calcul vérifié avec le script fourni.

Il avait d’abord inventé un numéro de devis. Il l’a retiré en relisant et me l’a signalé. La règle « sans rien deviner » a joué sur un champ que je n’avais même pas prévu. Petit raté quand même : il a écrit « aucune » dans les questions en attente. Le numéro aurait dû y figurer, comme le demande la dernière ligne de la skill.

Agent Skills : le même format dans Codex, ChatGPT, Cursor et Copilot

Le format SKILL.md est le même partout. Seuls l’emplacement du dossier et la façon d’appeler la skill changent.

• Claude Code ~/.claude/skills/ ou .claude/skills/ /devis-mail
• Codex ~/.agents/skills/ ou .agents/skills/ $devis-mail
• ChatGPT (Business, Enterprise, Healthcare, Edu) import dans l’espace Skills @devis-mail
• Cursor .cursor/skills/, .agents/skills/ ou .claude/skills/ /devis-mail
• GitHub Copilot .github/skills/, .agents/skills/ ou .claude/skills/ automatique

Et petit détail plutôt sympa : Cursor et GitHub Copilot lisent aussi le dossier .claude/skills/ d’un projet. Une skill rangée là sert donc à trois outils sans copie.

Les skills toutes prêtes et où en trouver

Anthropic fournit quatre skills pour créer des fichiers Word, Excel, PowerPoint et PDF. Elles marchent sur claude.ai et par l’API. Claude Code ne les a pas. Anthropic publie aussi des skills libres sur GitHub, dans le dépôt anthropics/skills.

Pour tout le reste, la règle d’Anthropic est stricte : installez seulement des skills écrites par vous ou par Anthropic. Une skill peut lancer du code sur votre machine. Lisez donc chaque fichier d’une skill trouvée ailleurs avant de l’ajouter.

Par où commencer

Prenez la tâche que vous réexpliquez le plus souvent à l’IA. Le devis est un bon candidat. La relance d’un client qui ne répond pas aussi.

Écrivez sa méthode une fois dans un SKILL.md et testez-la sur une vraie demande. Ajoutez un exemple ou un script seulement si le résultat flanche.

Téléchargez la skill devis-mail (zip de 5 fichiers) puis remplacez la grille par vos prix.

Vous voulez la même chose pour vos devis ou vos relances ? Je montre à votre équipe comment écrire ses skills, sur vos vrais dossiers. Réservez un appel de 30 minutes.

Une notion comme celle-ci sort chaque vendredi dans La vue éclatée, avec sa fiche à imprimer.

Questions fréquentes