# Skills Claude Code : écrire, installer, analyser

URL: https://agentvera.dev/fr/blog/claude-code-skills/ · Publié: 2026-10-24

Les skills Claude Code expliqués : format SKILL.md, dossiers projet et personnel, quand Claude charge un skill, et comment trouver, analyser et installer des skills.

**En bref:**

- Un skill est un dossier avec un fichier SKILL.md : nom et description dans le frontmatter, puis des instructions. Claude ne charge un skill complet que s’il est pertinent.
- Les skills de projet vivent dans .claude/skills et se partagent via git ; les skills personnels vivent dans ~/.claude/skills. Vous pouvez aussi appeler un skill directement avec /skill-name.
- Un skill est un ensemble d’instructions : traitez un skill téléchargé comme du code. La skill gallery d’AgentVera analyse chaque skill (commandes risquées, secrets, injection de prompt) avant l’installation.

**Les skills Claude Code sont des dossiers contenant un fichier `SKILL.md` qui apprennent à Claude une tâche répétable, comme relire une PR ou préparer une release, et Claude n’en charge un que lorsque votre demande en a besoin.** Les skills sont donc le bon endroit pour des instructions qui comptent pour certaines tâches mais pas pour chaque session. Le piège : un skill est un ensemble d’instructions que votre agent suivra, et un skill venu d’Internet mérite le même soin qu’un script venu d’Internet.

Cet article couvre le format des skills, leur emplacement, la façon dont Claude les choisit, comment en écrire un bon, et comment trouver et installer des skills partagés sans confier à votre agent quelque chose de dangereux.

## Ce qu’est un skill Claude Code

Un skill est un dossier. Le seul fichier obligatoire est `SKILL.md` :

```markdown
---
name: release-notes
description: Use when the user asks for release notes or a changelog entry for a version.
---

1. Run `git log --oneline <last-tag>..HEAD`.
2. Group the commits into Features, Fixes and Other.
3. Write one plain sentence per change, for users, not developers.
4. Ask before writing to CHANGELOG.md.
```

Le frontmatter contient le `name` et la `description`. Le corps est l’instruction que Claude suit une fois le skill chargé. Le dossier peut aussi contenir des scripts et des fichiers de référence vers lesquels les instructions renvoient, si bien qu’un skill peut dire « lance `scripts/check.sh` » ou « lis `reference/api.md` pour la liste des endpoints ».

## Où vivent les skills Claude Code

| Emplacement | Qui l’obtient | Usage typique |
| --- | --- | --- |
| `.claude/skills/<name>/SKILL.md` | Tous ceux qui travaillent sur le dépôt, via git | Workflows de projet : déploiement, migrations, release |
| `~/.claude/skills/<name>/SKILL.md` | Vous, dans chaque projet | Habitudes personnelles : votre checklist de relecture, votre style de commit |

Le nom du dossier devient la commande : `.claude/skills/release-notes/SKILL.md` peut aussi se lancer avec `/release-notes`. Tapez `/skills` dans une session pour lister les skills que Claude voit. Pour les autres commandes slash, voir l’[aide-mémoire des commandes Claude Code](/fr/blog/claude-code-commands-cheat-sheet/ "Aide-mémoire des commandes Claude Code").

## Comment Claude décide d’utiliser un skill

Au début d’une session, Claude voit les descriptions des skills, pas leur corps complet. Quand votre demande correspond à une description, il charge ce skill. Deux conséquences :

- **La description fait le routage.** « Skill de notes de version » est une description faible. « Use when the user asks for release notes or a changelog entry for a version » dit à Claude quand s’en servir.
- **Les skills gardent petit votre contexte de base.** Seules les descriptions se chargent à chaque session : sortir de `CLAUDE.md` les instructions propres à une tâche pour les mettre dans des skills allège chaque tour. Plus de détails dans [la fenêtre de contexte de Claude Code](/fr/blog/claude-code-context-window/ "Fenêtre de contexte de Claude Code").

## Skills, CLAUDE.md, subagents et MCP

Ces quatre se recoupent, il est donc utile de savoir lequel convient.

| Outil | Chargé | Idéal pour |
| --- | --- | --- |
| `CLAUDE.md` | À chaque session, fichier entier | Règles qui s’appliquent toujours |
| Skill | Description toujours, corps à la demande | Un workflow que vous répétez de temps en temps |
| Subagent | Quand il est délégué, dans son propre contexte | Un gros travail dont vous n’avez pas besoin des détails |
| Serveur MCP | Définitions d’outils à chaque session | Accès à des systèmes ou données extérieurs |

Si vous collez le même paragraphe dans vos prompts deux fois par semaine, cela devrait être un skill. Si l’agent doit parler à une base de données ou à une API, c’est un serveur MCP ([ce qu’est un serveur MCP](/fr/blog/what-is-mcp-server/ "Qu’est-ce qu’un serveur MCP ?")).

## Comment écrire un bon skill

1. **Partez d’une tâche que vous répétez déjà.** Notez les étapes que vous tapez aujourd’hui.
2. **Écrivez la description comme un déclencheur.** Commencez par « Use when… » et nommez les mots qu’un utilisateur dirait.
3. **Gardez le corps court et ordonné.** Des étapes numérotées valent mieux que des paragraphes.
4. **Mettez le contenu long dans des fichiers.** Un tableau de référence ou un script va à côté de `SKILL.md`, et le corps dit quand le lire ou l’exécuter.
5. **Dites ce qu’il ne faut pas faire.** « Ask before writing to CHANGELOG.md » évite la surprise que vous corrigeriez sinon à la main.
6. **Testez-le dans une session neuve.** Demandez la tâche avec vos propres mots et vérifiez que Claude choisit le skill sans qu’on le lui dise.

## Le risque des skills partagés

Le partage de skills est ce qui les rend utiles, et risqués. Un skill peut demander à votre agent d’exécuter une commande shell, de lire un fichier hors du projet ou d’envoyer quelque chose vers une URL. Si votre agent tourne avec de larges permissions, un skill malveillant ou négligent s’exécute avec elles. À repérer avant d’en installer un :

- Commandes destructrices ou privilégiées (`rm -rf`, `sudo`)
- Lecture de secrets, comme des fichiers `.env` ou des clés SSH
- Envoi de données vers un hôte inconnu
- Schémas de téléchargement-exécution, comme faire passer `curl` dans un shell
- Code obscurci ou caractères Unicode cachés
- Injection de prompt : du texte qui tente de contourner vos instructions

L’article sur la [sécurité des agents de code IA](/fr/blog/ai-coding-agent-security/ "Sécurité des agents de code IA") traite plus en profondeur des permissions et du sandboxing.

## Gérer les skills dans AgentVera

La [skill gallery](/fr/features/skill-gallery/ "Skill gallery") d’AgentVera se trouve dans la page Details d’un projet, **Automation → Skills**. Elle a trois vues : **Local**, **Discover** et **My published**.

**Local** liste les skills de votre ordinateur pour les deux agents qui utilisent des dossiers de skills :

| Agent | Dossier du projet | Dossier personnel |
| --- | --- | --- |
| Claude Code | `.claude/skills` | `~/.claude/skills` |
| Codex | `.agents/skills` | `~/.codex/skills` |

De là, vous pouvez :

- En créer un avec **New skill** : choisissez l’**Agent** (Claude Code ou Codex), le **Scope** (**This project** ou **All projects**), un **Name** (lettres minuscules, chiffres et tirets) et **When should it be used?**, qui devient la description. **Create and edit** ouvre le nouveau `SKILL.md`.
- Désactiver un skill sans le supprimer. L’interrupteur déplace le dossier vers un endroit que les CLI n’analysent pas.
- Prévisualiser ou modifier `SKILL.md`, copier un skill vers l’autre agent ou l’autre portée, ou le supprimer, ce qui déplace le dossier vers la Corbeille.

## Trouver et installer des skills en sécurité

**Discover** affiche les skills de votre organisation et la galerie publique. Recherchez, choisissez l’une des 10 catégories (coding, testing, code review, DevOps, data, docs, design, security, productivity, other), filtrez par agent et triez par **Popular** ou **New**. La même galerie est sur le web à app.agentvera.dev/skills.

La vue détaillée de chaque skill a des onglets **Files**, **Security** et **Versions**. L’onglet Security affiche le **Server scan**. L’analyse cherche des commandes destructrices ou privilégiées, la lecture de secrets, des clés intégrées, des données envoyées à l’extérieur, du téléchargement-exécution, du code obscurci, de l’injection de prompt, de l’Unicode caché, des adresses IP brutes et des hôtes extérieurs. Les résultats vont de propre à critique, en passant par info, risque faible, moyen et élevé.

L’installation se fait en deux étapes :

1. **Download and scan.** AgentVera télécharge les fichiers, vérifie leur SHA-256 et les analyse de nouveau sur votre ordinateur.
2. **Install.** Les scripts sont écrits comme de simples fichiers et ne sont pas rendus exécutables.

Les agents voient le skill dès leur prochaine session. Quand une nouvelle version est publiée, un bouton de mise à jour apparaît à côté du skill installé. Les skills de la galerie ne s’installent que pour les agents qu’ils prennent en charge, Claude Code et Codex.

Les skills publics passent une analyse de sécurité et une revue par un modérateur, mais regardez quand même les constats et les fichiers. L’analyse détecte des schémas ; vous savez ce que votre projet doit et ne doit pas faire.

## Partager vos propres skills

Avec un forfait Pro ou Team et un compte AgentVera, **Share** publie un skill local. Vous lui donnez un titre, un résumé de 20 à 300 caractères, jusqu’à 6 tags, une catégorie et une version comme `1.0.0`, avec un changelog pour chaque version. Un skill est limité à 50 fichiers texte, 256 Ko par fichier et 1 Mo au total.

- **Organization only :** visible tout de suite pour votre organisation si l’analyse ne trouve rien d’élevé ou de critique ; sinon il est refusé.
- **Public :** attend l’approbation d’un modérateur, et les constats critiques ne sont pas acceptés. Suivez-le dans **My published**.

## Skills et consommation de tokens

Chaque skill ajoute sa description au contexte de base. Une poignée, ça va ; des dizaines de skills personnels s’additionnent à chaque tour. Le profil Lean context d’AgentVera ne charge pas les skills de niveau utilisateur, ce qui est l’une des raisons pour lesquelles sa première requête est plus petite ([mesuré ici](/fr/blog/claude-code-token-usage/ "Réduire de 61 % la consommation de tokens de Claude Code")). Gardez les skills de projet dans le dépôt et élaguez les skills personnels que vous n’utilisez plus.

## En résumé

Les skills Claude Code transforment des prompts répétés en dossiers que Claude charge à la demande : un `SKILL.md` avec une description « use when » claire, des étapes courtes et ordonnées et les scripts nécessaires, dans `.claude/skills` pour le projet ou `~/.claude/skills` pour vous. Les skills partagés ne valent la peine que si vous les vérifiez d’abord. AgentVera liste les skills Claude Code et Codex au même endroit, analyse les skills de la galerie sur le serveur puis de nouveau sur votre ordinateur avant l’installation, et laisse les utilisateurs Pro et Team publier les leurs. [Téléchargez AgentVera](/fr/download/) pour gérer vos skills.

## Questions fréquentes

**Que sont les skills Claude Code ?** Des instructions réutilisables, regroupées dans un dossier avec un fichier SKILL.md. Le frontmatter contient un nom et une description ; le corps dit quoi faire. Le dossier peut aussi contenir des scripts et des fichiers de référence vers lesquels le skill renvoie.

**Où placer un skill Claude Code ?** Dans .claude/skills/<name>/SKILL.md pour un projet, afin que tous ceux qui travaillent sur le dépôt l’aient, ou dans ~/.claude/skills/<name>/SKILL.md pour vous-même dans tous les projets.

**Comment Claude décide-t-il d’utiliser un skill ?** Il voit les descriptions des skills et charge le skill complet quand votre demande en correspond à un. C’est pourquoi la description doit dire quand utiliser le skill, pas seulement ce qu’il est. Vous pouvez aussi le lancer vous-même avec /skill-name.

**Les skills trouvés sur Internet sont-ils sûrs à installer ?** Pas par défaut. Un skill peut demander à votre agent d’exécuter des commandes, de lire des fichiers ou d’envoyer des données à l’extérieur. Lisez-le d’abord. AgentVera analyse les skills de la galerie à la recherche de commandes destructrices, de lecture de secrets, d’envoi de données, de téléchargement-exécution et d’injection de prompt, puis les réanalyse sur votre ordinateur avant l’installation.

**La skill gallery d’AgentVera est-elle payante ?** Gérer, parcourir et installer des skills fait partie de l’offre gratuite. Publier vos propres skills dans la galerie demande un forfait Pro ou Team et un compte AgentVera.

---

**À propos d’AgentVera.** AgentVera est une app de bureau pour macOS, Windows et Linux, développée par Solviera Teknoloji. Elle exécute 18 agents de code IA (Claude Code, Codex, Gemini CLI, Copilot, Cursor, Antigravity, opencode, Hermes, Qwen Code, Kimi Code, Kiro, Amp, Droid, Goose, Vibe, Crush, Aider, Cline) côte à côte, par projet, dans de vrais terminaux avec les installations et connexions CLI de l’utilisateur. L’offre gratuite inclut des agents illimités. Télécharger: https://agentvera.dev/fr/download/ · Tarifs: https://agentvera.dev/fr/pricing/