Skills Claude : comment les ajouter à Claude et Claude Code

Pour ajouter un skill à Claude, tu crées un dossier qui contient un fichier SKILL.md, puis tu le places là où Claude peut le lire : dans l’application claude.ai via Customize > Skills (import d’un fichier ZIP), dans Claude Code en le déposant dans ~/.claude/skills/ ou .claude/skills/, ou par l’API en l’envoyant sur l’endpoint /v1/skills. Claude charge ensuite le skill tout seul quand ta demande correspond à sa description. Un skill ajouté à un endroit n’apparaît pas automatiquement ailleurs, sauf dans un cas précis détaillé plus bas.

Qu’est-ce qu’un skill Claude ?

Un skill Claude désigne un dossier d’instructions, de scripts et de ressources que Claude charge à la demande pour réaliser une tâche spécialisée de façon répétable. C’est la définition du centre d’aide d’Anthropic, qui cite comme exemples l’application d’une charte graphique, un format de compte rendu de réunion ou une analyse de données propre à une entreprise (source : Claude Help Center). Dans la documentation développeur, la fonction s’appelle « Agent Skills » : c’est le nom anglais que tu croiseras dans les menus et les guides.

Au lieu de recoller le même long prompt à chaque conversation, tu l’écris une fois dans un fichier, et Claude le retrouve quand il en a besoin.

La divulgation progressive (progressive disclosure) désigne la façon dont Claude charge un skill par étapes plutôt que d’un bloc. Anthropic en décrit trois niveaux (source : Claude Docs, Agent Skills) :

Conséquence pratique : tu peux installer beaucoup de skills sans alourdir chaque conversation, mais la description doit être assez précise pour que Claude sache quand ouvrir le reste.

Le centre d’aide distingue aussi le skill des autres réglages de Claude :

• MCP connecte Claude à des services et des données externes. Le skill apporte la procédure, c’est-à-dire la manière de faire. Les deux se combinent.
• Un projet fournit un contexte fixe, toujours chargé dans ses conversations. Un skill s’active seulement quand il sert, dans n’importe quelle conversation.
• Les instructions personnalisées s’appliquent à toutes tes conversations. Un skill est propre à un type de tâche.

Pour le panorama complet de ces briques, agents compris, lis MCP, Skills, agents : ce que Claude sait vraiment faire.

Où ajouter un skill : claude.ai, Claude Code ou API ?

Les skills personnalisés ne se synchronisent pas entre l’application et l’API : un skill importé dans claude.ai doit être envoyé séparément à l’API, et inversement (source : Claude Docs, Agent Skills, Limitations and constraints). La seule passerelle est Claude Code : connecté avec ton compte claude.ai, il télécharge les skills activés sur ce compte dans ~/.claude/skills/synced/, en sens unique (Claude Code v2.1.273 ou plus récent).

Ajouter un skill dans l’application Claude (claude.ai)

Les skills sont disponibles sur les offres Free, Pro, Max, Team et Enterprise, à condition que l’exécution de code soit activée (source : Claude Help Center, Using Skills in Claude). Sur une offre individuelle, la marche à suivre est la suivante :

1. Ouvre Settings > Capabilities et vérifie que Code execution and file creation est activé.
2. Va dans Customize > Skills.
3. Clique sur le bouton +, puis sur + Create skill.
4. Choisis Upload a skill et importe ton fichier ZIP.
5. Le skill apparaît dans ta liste, avec un interrupteur pour l’activer ou le désactiver.

Le ZIP doit contenir le dossier du skill à sa racine (mon-skill.zip, qui contient mon-skill/, qui contient SKILL.md), pas les fichiers en vrac. Pour un skill créé dans l’application, le centre d’aide limite le nom à 64 caractères et la description à 200 caractères (source : Claude Help Center, How to create custom Skills).

Sur les offres Team et Enterprise, c’est le propriétaire de l’organisation qui contrôle les skills, dans Organization settings > Plugins & skills, onglet Policy (ils sont activés par défaut sur l’offre Team). Si le partage est autorisé, chaque membre peut partager un skill avec des collègues (menu … puis Share) ou le proposer à toute l’organisation avec Publish to org.

Les skills d’Anthropic (Excel, Word, PowerPoint, PDF) ne demandent aucune installation : dès que l’exécution de code est activée, Claude s’en sert tout seul quand ta demande s’y prête.

Ajouter un skill dans Claude Code (.claude/skills)

Dans Claude Code, un skill est un simple dossier sur ton disque, sans import. Son emplacement décide de sa portée (source : Claude Code Docs, Extend Claude with skills) :

Pour créer un skill personnel, une commande suffit :

mkdir -p ~/.claude/skills/checklist-mise-en-ligne

Ajoute ensuite le fichier SKILL.md dans ce dossier (sa structure est détaillée plus bas). Le nom du dossier devient la commande : ici, /checklist-mise-en-ligne. Claude peut aussi lancer le skill tout seul quand ta demande correspond à sa description.

Quelques règles utiles :

• Pas besoin de redémarrer : Claude Code surveille ces dossiers et prend en compte un skill ajouté ou modifié pendant la session. Seule exception : si le dossier skills n’existait pas au lancement, tape /reload-skills.
• Voir ses skills : la commande /skills liste les skills chargés. Dans l’extension VS Code, taper /skills ouvre cette liste dans une fenêtre (Claude Code v2.1.280 ou plus récent).
• Même nom à deux endroits : le skill personnel passe avant celui du projet.
• Anciennes commandes : un fichier .claude/commands/deploy.md fonctionne toujours et crée /deploy. Le format skill ajoute un dossier pour les fichiers annexes et le déclenchement automatique.

Pour installer des skills déjà écrits, Claude Code passe par les plugins. Le dépôt public d’exemples d’Anthropic, anthropics/skills, s’ajoute comme marketplace :

/plugin marketplace add anthropics/skills
/plugin install document-skills@anthropic-agent-skills

Claude Code embarque aussi des skills intégrés (bundled skills), comme /code-review, /simplify ou /debug, qui se lancent de la même façon.

Ajouter un skill par l’API Claude

Côté développeur, un skill personnalisé s’envoie sur l’endpoint POST /v1/skills, sous forme de ZIP ou de fichiers séparés. Il devient accessible à tout l’espace de travail, puis s’appelle dans une requête Messages par le paramètre container, avec l’outil d’exécution de code (source : Claude Docs, Using Agent Skills with the API) :

"container": {
  "skills": [
    { "type": "custom", "skill_id": "skill_01AbCdEfGhIjKlMnOpQrStUv", "version": "latest" }
  ]
},
"tools": [{ "type": "code_execution_20250825", "name": "code_execution" }]

Les skills d’Anthropic s’appellent de la même manière, avec "type": "anthropic" et les identifiants pptx, xlsx, docx ou pdf. Limites documentées : 20 skills au maximum par requête, 30 Mo au total par skill (fichiers décompressés), et un conteneur sans accès réseau ni installation de paquets pendant l’exécution. L’API Skills est sortie de la bêta : l’en-tête skills-2025-10-02 n’est plus nécessaire.

Structure d’un fichier SKILL.md

Le seul fichier obligatoire est SKILL.md. Le frontmatter désigne le bloc YAML placé entre deux lignes --- en tête du fichier : c’est lui que Claude lit en permanence. Les instructions en Markdown suivent. Voici un skill complet, utilisable aussi bien dans claude.ai, dans Claude Code que par l’API :

---
name: checklist-mise-en-ligne
description: Vérifie un site avant sa mise en ligne (title, meta description, liens cassés, images sans alt, page 404). Utiliser pour une livraison ou un contrôle final.
---

# Checklist de mise en ligne

## Étapes
1. Liste les pages du site à partir du sitemap ou du dossier des routes.
2. Pour chaque page, vérifie la balise title (60 caractères maximum) et la meta description.
3. Repère les images sans attribut alt et les liens internes en erreur 404.
4. Vérifie que la page 404 et les mentions légales existent.
5. Rends un tableau en trois colonnes (page, problème, correction proposée).

## Ressources
- Règles détaillées dans [regles-seo.md](regles-seo.md)

Les deux champs obligatoires suivent des règles strictes (source : Claude Docs, Agent Skills, Skill structure) :

• name : 64 caractères maximum, uniquement des minuscules, des chiffres et des traits d’union, sans les mots réservés « anthropic » et « claude ». La spécification ouverte Agent Skills demande en plus qu’il soit identique au nom du dossier.
• description : ce que fait le skill et quand l’utiliser, en 1 024 caractères maximum côté API. C’est le texte que Claude compare à ta demande pour décider de charger le skill. Pour un import dans claude.ai, reste sous les 200 caractères indiqués par le centre d’aide.

Le dossier peut contenir d’autres fichiers, que Claude lit seulement quand les instructions y renvoient :

checklist-mise-en-ligne/
├── SKILL.md
├── regles-seo.md
└── scripts/
    └── verifier_liens.py

Anthropic recommande de garder le corps du SKILL.md sous 500 lignes, de déplacer le détail dans ces fichiers annexes et d’écrire la description à la troisième personne, parce qu’elle est injectée dans le prompt système (source : Claude Docs, Skill authoring best practices).

Claude Code accepte des champs supplémentaires, comme disable-model-invocation: true (toi seul peux lancer le skill) ou paths (le skill ne s’active que sur certains fichiers). Un import dans claude.ai ou par l’API n’accepte en revanche que les six champs de la spécification (name, description, license, compatibility, metadata, allowed-tools) et renvoie une erreur sur tout autre champ.

Exemples de skills Claude pour un site web

Un bon candidat est une tâche que tu refais souvent avec les mêmes règles. Quelques exemples pour un site :

• Checklist de mise en ligne : le skill ci-dessus, lancé avant chaque livraison.
• Charte éditoriale du blog : ton, structure type d’un article, typographie française, longueur visée. Claude l’applique dès que tu demandes un article.
• Conventions de code du site : nommage des composants, organisation des pages, règles d’accessibilité. C’est un skill « de référence », sans étapes, que Claude consulte pendant qu’il code. Place-le dans .claude/skills/ du dépôt pour que toute l’équipe l’ait.
• Charte graphique : couleurs, polices et usage du logo pour les maquettes et les documents, un cas d’usage cité par Anthropic.
• Déploiement : étapes de build et de mise en production, avec disable-model-invocation: true dans Claude Code. La documentation prend cet exemple : tu ne veux pas que Claude décide seul de déployer parce que le code semble prêt.

La description et les instructions d’un skill s’écrivent comme un bon prompt : contexte, étapes, format de sortie attendu. Les principes de notre méthode pour écrire un bon prompt s’appliquent tels quels, et un prompt que tu réutilises chaque semaine, comme ceux de notre guide Claude en 10 prompts, fait souvent un excellent premier skill.

Tester, mettre à jour et dépanner un skill

Un skill raté échoue de deux façons : il ne se déclenche jamais, ou il se déclenche trop souvent. La documentation de Claude Code propose ces vérifications (source : Claude Code Docs, Troubleshooting) :

1. Demande What skills are available? pour vérifier que Claude voit le skill.
2. Formule une demande avec les mots de la description, puis une demande voisine hors sujet.
3. S’il ne part pas, ajoute dans la description les mots que tu emploies vraiment. S’il part trop souvent, précise-la, ou ajoute disable-model-invocation: true pour ne le lancer qu’à la main.
4. Si le frontmatter est mal formé, Claude ne peut plus lire la description. La commande claude plugin validate .claude/skills repère les SKILL.md invalides (Claude Code v2.1.233 ou plus récent).

Pour aller plus loin, le plugin skill-creator d’Anthropic compare les réponses avec et sans le skill, puis propose des retouches de la description. Il s’installe avec /plugin install skill-creator@claude-plugins-official.

Pour mettre à jour un skill dans Claude Code, il suffit de modifier le fichier : le changement s’applique dans la session en cours. Dans claude.ai, tu peux retoucher les fichiers d’un skill ouverts à côté de la conversation (bouton Edit with Claude), ou supprimer le skill (menu … puis Delete) et importer le nouveau ZIP.

Dernier point, la sécurité. Un skill peut faire exécuter du code. Anthropic recommande de n’utiliser que des skills que tu as écrits ou qui viennent d’Anthropic, et d’auditer tous les fichiers d’un skill tiers avant de l’activer, scripts compris (source : Claude Docs, Agent Skills, Security considerations).

FAQ