Cyril DE LA RUE
Claude Code Skill : créer, packager et déployer un skill sur-mesure
Un skill Claude Code transforme l'agent en spécialiste de votre contexte : il sait quand appeler votre CRM, comment interroger votre base de données, quelles règles suivre. Ce guide expert montre comment créer, packager et déployer un skill sur-mesure qui connecte Claude Code à vos API d'entreprise, avec la structure exacte et un exemple tiré de notre propre stack chez Oakflow AI.
Un skill Claude Code est un dossier contenant un fichier SKILL.md (en-tête YAML name + description) et, éventuellement, des scripts. Placez-le dans ~/.claude/skills/ (personnel) ou .claude/skills/ (projet). L'agent charge la description au démarrage et n'ouvre le contenu complet que quand la tâche correspond : c'est ce qui rend les skills légers et fiables.
Qu'est-ce qu'un skill Claude Code ?
Un skill (ou Agent Skill) est une capacité réutilisable que vous packagez pour que Claude Code l'active automatiquement quand le contexte s'y prête. Là où un prompt se retape à chaque fois, un skill est documenté une fois et l'agent s'en sert seul, au bon moment.
Le mécanisme repose sur le progressive disclosure : au démarrage, Claude Code ne lit que le nom et la description de chaque skill (quelques lignes). Quand votre demande correspond à cette description, il ouvre alors le contenu complet du skill, puis, si besoin, les scripts et fichiers de référence embarqués. Résultat : vous pouvez avoir des dizaines de skills sans alourdir le contexte.
Anatomie d'un skill : la structure de dossier
Un skill est un simple dossier, nommé en kebab-case, contenant au minimum un SKILL.md. Il peut aussi embarquer des scripts et des ressources :
.claude/skills/
└── crm-lookup/
├── SKILL.md # instructions + en-tête YAML
├── scripts/
│ └── query_crm.py # appelle votre API CRM
└── references/
└── champs-crm.md # doc des champs, chargée au besoinLe cœur, c'est le SKILL.md. Son en-tête YAML déclare deux champs essentiels : name (identifiant en kebab-case) et description (quand utiliser le skill). C'est cette description que l'agent lit pour décider de déclencher le skill :
---
name: crm-lookup
description: Recupere la fiche d'un client depuis notre CRM interne. A utiliser des que l'utilisateur demande des infos sur un client, un contact ou une societe par son nom ou son email.
---
# CRM Lookup
Quand l'utilisateur demande des informations sur un client :
1. Recupere l'identifiant ou l'email mentionne.
2. Execute `python scripts/query_crm.py --query ""`.
3. Presente les champs cles (societe, statut, dernier contact) en tableau.
4. Ne jamais afficher les champs marques sensibles dans references/champs-crm.md. Règle d'or de la description : elle doit dire quand utiliser le skill, avec les mots que vous employez naturellement. C'est le seul signal dont dispose l'agent pour choisir de le déclencher. Une description vague = un skill jamais utilisé.
Créer un skill qui appelle une API d'entreprise
C'est l'usage le plus puissant : donner à Claude Code un accès contrôlé à vos outils métier. Le principe est toujours le même en trois temps :
- Un script embarqué (Python, Node, shell) qui appelle votre API (CRM, ERP, base de données, ou un webhook n8n) et renvoie un résultat propre, en JSON de préférence.
- Le SKILL.md qui indique à l'agent quand lancer ce script, avec quels arguments, et comment interpréter la réponse.
- La gestion des secrets : la clé d'API se lit dans une variable d'environnement, jamais en dur dans le skill. Le script échoue proprement si elle manque.
# scripts/query_crm.py (extrait)
import os, sys, json, urllib.request
API = os.environ["CRM_API_URL"]
KEY = os.environ["CRM_API_KEY"] # jamais en dur dans le skill
def lookup(query):
req = urllib.request.Request(
f"{API}/contacts?search={query}",
headers={"Authorization": f"Bearer {KEY}"},
)
with urllib.request.urlopen(req) as r:
return json.load(r)
print(json.dumps(lookup(sys.argv[-1]), ensure_ascii=False))À partir de là, quand vous demandez à Claude Code « donne-moi la fiche de la société Martin », l'agent reconnaît le contexte via la description, exécute le script, et vous renvoie une synthèse. Aucune intégration à recoder à chaque session.
Notre exemple concret chez Oakflow AI
Nous ne parlons pas en théorie : chez Oakflow AI, nous construisons nos propres skills Claude Code pour outiller notre production. Un exemple réel est notre skill de prospection sur le département 92 : il orchestre une chaîne complète (sourcing des entreprises via une API d'enrichissement, écriture dans notre base Supabase de leads, mise à jour d'un Google Sheet, puis génération de brouillons d'e-mails de premier contact).
Concrètement, le SKILL.md décrit la cible (secteur, zone géographique), et les scripts embarqués appellent tour à tour les API concernées. Quand nous lançons une session de prospection, l'agent enchaîne les étapes sans que nous ayons à réécrire quoi que ce soit. C'est exactement la logique « API d'entreprise » décrite plus haut, appliquée à notre métier. Le même principe alimente notre chaîne de production d'automatisations.
Retour d'expérience : le facteur numéro un de fiabilité d'un skill n'est pas le code, c'est la clarté des instructions dans le SKILL.md. Un skill bien écrit se comporte de façon prévisible ; un skill flou produit des résultats erratiques. On passe plus de temps sur les instructions que sur les scripts.
Packager et déployer un skill dans votre équipe
Un skill personnel vit dans ~/.claude/skills/. Pour le partager avec toute une équipe, deux approches :
- Au niveau du projet : placez le skill dans .claude/skills/ à la racine du dépôt et versionnez-le avec Git. Tous ceux qui clonent le projet héritent du skill.
- Via un plugin : packagez un ou plusieurs skills dans un plugin Claude Code, distribuable par un marketplace interne. Idéal pour diffuser un socle commun à plusieurs projets.
Dans les deux cas, documentez les variables d'environnement requises (clés d'API) et gardez une version des skills : ils évoluent avec vos API. Pour installer Claude Code au préalable, suivez notre guide d'installation de Claude Code.
Skill Claude Code ou n8n : lequel pour quoi ?
Un skill outille l'agent pendant que vous travaillez : il est parfait pour le développement, l'exploration, les tâches ponctuelles pilotées par un humain. Mais dès qu'un processus doit tourner en production, en autonomie, 24/7 (relances, synchronisations, traitements planifiés), ce n'est plus le rôle d'un skill : c'est celui d'un moteur d'automatisation comme n8n ou Make.
La bonne pratique que nous appliquons : on prototype une logique avec Claude Code et un skill, puis on industrialise le workflow récurrent dans n8n. Le skill reste l'outil du développeur ; n8n devient l'ouvrier qui tourne sans surveillance. Si vous voulez automatiser un process métier de bout en bout sans surcharger vos équipes de code, notre agence d'automatisation prend le relais.
Un process à automatiser au-delà du prototype ?
On transforme vos idées d'automatisation en workflows fiables et industrialisés (n8n, Make, agents). Audit gratuit de 30 minutes pour cadrer le bon outil.
Réserver mon audit gratuit →Questions fréquentes
Qu'est-ce qu'un skill Claude Code ?
Une capacité réutilisable packagée dans un dossier contenant un fichier SKILL.md. Cet en-tête YAML (name, description) dit à l'agent quand et comment l'utiliser. Un skill peut embarquer des scripts et des fichiers de référence, par exemple pour interroger une API d'entreprise. Claude Code charge la description au démarrage et le contenu complet seulement quand la tâche correspond.
Comment créer un skill Claude Code ?
Créez un dossier au nom du skill (kebab-case) dans ~/.claude/skills ou .claude/skills à la racine du projet, puis un fichier SKILL.md avec son en-tête YAML (name, description). Le corps contient les instructions que l'agent suit quand le skill est déclenché. Vous pouvez y joindre des scripts (Python, Node, shell) que l'agent exécute, notamment pour appeler vos API internes.
Un skill Claude Code peut-il appeler une API d'entreprise ?
Oui, c'est un usage courant : le skill embarque un script qui appelle votre API (CRM, ERP, base de données, webhook n8n), et le SKILL.md indique quand l'exécuter et comment interpréter la réponse. C'est la façon propre de donner à Claude Code un accès contrôlé à vos outils métier, sans recoder l'intégration à chaque session.
Quelle différence entre un skill Claude Code et n8n ?
Un skill outille l'agent côté développement, piloté par un humain. n8n automatise des processus métier en production, en autonomie et 24/7. Les deux sont complémentaires : on prototype avec Claude Code, puis on industrialise le workflow récurrent dans n8n ou Make.