Claude Code agents vs skills : lequel choisir

Castel Studio, Nice · Publié le 14 octobre 2026

Claude Code agents vs skills : c’est l’une des premières questions qui se posent dès qu’une configuration dépasse un simple fichier CLAUDE.md. Les deux vivent dans .claude/, les deux sont du Markdown avec quelques lignes de YAML en en-tête, et les deux peuvent être déclenchés automatiquement. Ils répondent pourtant à des problèmes différents, et les confondre est le meilleur moyen de rendre une configuration lente et imprévisible.

En version courte : une skill ajoute du savoir-faire à la conversation en cours ; un subagent effectue un travail dans un contexte séparé et ne rapporte que le résultat. Tout ce qui suit s’appuie sur la documentation officielle des subagents et des skills. Nous utilisons les deux chaque jour dans notre studio, et la règle en fin d’article vient de ce travail.

Ce qu’est un subagent

Un subagent est un assistant spécialisé qui s’exécute dans sa propre fenêtre de contexte, avec son propre prompt système, son propre accès aux outils et ses propres permissions. Il ne voit pas l’historique de votre conversation. Claude lui écrit une tâche, le subagent travaille, et seul un résumé revient.

C’est tout l’intérêt : une tâche annexe qui noierait la conversation principale sous les résultats de recherche, les logs ou le contenu de fichiers reste confinée dans le subagent.

---
name: code-reviewer
description: Reviews code for quality and best practices
tools: Read, Glob, Grep
model: sonnet
---

You are a code reviewer. When invoked, analyze the code and provide
specific, actionable feedback on quality, security, and best practices.

Enregistrez-le sous .claude/agents/code-reviewer.md pour un seul projet ou ~/.claude/agents/code-reviewer.md pour tous. Seuls name et description sont obligatoires. tools est une liste d’autorisation : si vous l’omettez, le subagent reçoit tous les outils disponibles pour les subagents.

Claude délègue de lui-même quand une tâche correspond à la description. Vous pouvez aussi l’appeler par son nom, ou le mentionner en tant que @"code-reviewer (agent)" pour être sûr qu’il s’exécute. Claude Code embarque aussi des subagents intégrés, comme Explore pour les recherches rapides en lecture seule et Plan pour la recherche en mode plan.

Ce qu’est une skill

Une skill est un dossier avec un fichier SKILL.md : des instructions plus, éventuellement, des fichiers annexes comme des notes de référence ou des scripts. Elle s’exécute dans la conversation principale, pas dans un contexte séparé.

---
name: summarize-changes
description: Summarizes uncommitted changes and flags anything risky. Use when the user asks what changed, wants a commit message, or asks to review their diff.
---

Summarize the uncommitted changes in two or three bullet points,
then list anything risky: deleted files, changed permissions, new dependencies.

Enregistrez-la sous .claude/skills/summarize-changes/SKILL.md. Par défaut, vous et Claude pouvez l’utiliser : vous tapez /summarize-changes, ou Claude la charge quand votre requête correspond à la description.

Le détail qui compte pour le coût : lors d’une session normale, seules les descriptions des skills occupent le contexte. Le contenu complet se charge quand la skill est utilisée. Une longue documentation de référence dans une skill ne coûte presque rien tant qu’elle n’est pas nécessaire, contrairement au texte dans CLAUDE.md, qui est toujours présent.

Les commandes slash personnalisées font maintenant partie des skills : .claude/commands/deploy.md et .claude/skills/deploy/SKILL.md créent tous deux /deploy.

Claude Code agents vs skills, côte à côte

	Subagent	Skill
Où il s’exécute	sa propre fenêtre de contexte	la conversation principale
Voit votre conversation	non	oui
Ce qui revient	un résumé	le travail se fait sur place
Fichier	`.claude/agents/name.md`	`.claude/skills/name/SKILL.md`
Déclencheur typique	Claude délègue une tâche	Claude ou vous avec `/name`
Utile pour	recherches, revues, longues tâches annexes	procédures, règles maison, documentation

Ils se combinent aussi. Un subagent peut précharger des skills via son champ skills, pour qu’un relecteur démarre avec votre checklist. Et une skill avec context: fork s’exécute dans un subagent : le texte de la skill devient la tâche, et votre contexte principal reste propre.

Une règle simple pour choisir

Posez une seule question : ai-je besoin des détails de ce travail dans la conversation ensuite ?

Non, seulement le résultat. Utilisez un subagent. Explorer une grande base de code, relire un diff, lire de longs logs : vous voulez la conclusion, pas chaque fichier ouvert.
Oui, cela fait partie de ce que je fais maintenant. Utilisez une skill. Une checklist de release, votre format de message de commit, la façon dont votre projet nomme les choses : des connaissances que la conversation doit suivre.

Deux signaux d’alerte venus du terrain. Si une section de CLAUDE.md est devenue une procédure pas à pas, elle réclame de devenir une skill. Si une skill n’arrête pas d’attirer des dizaines de fichiers dans la conversation, elle réclame context: fork ou un subagent.

Les erreurs qui rendent une configuration imprévisible

Descriptions vagues. Les deux sont choisis via leur description. « Aide avec le code » correspond à tout et à rien. Dites ce que ça fait et quand l’utiliser.
Trop de descriptions longues. Les descriptions sont chargées au début de chaque session. Gardez-les courtes et mettez le détail dans le corps.
Un subagent avec tous les outils par défaut. Si un relecteur n’a besoin que de lire, donnez-lui Read, Glob, Grep et rien d’autre.
Des règles qui doivent être respectées, écrites comme une skill. Une skill guide ; elle n’impose rien. Pour « ne jamais faire ceci », utilisez des règles de permission et des hooks, comme expliqué dans notre article sur les hooks Claude Code.

Quand nous confier la suite

Si votre dossier .claude/ a grandi vite et que personne ne sait plus quel agent ou quelle skill fait quoi, nous cartographions la configuration, nettoyons les agents et les skills, et ajoutons des règles testées. Vous pouvez voir comment notre propre système est construit sur la page réalisations.

Questions

Une skill n'est-elle qu'un prompt enregistré ?

Presque, mais c'est plus que ça. Une skill est un dossier avec un fichier SKILL.md et éventuellement des fichiers annexes. Claude ne voit que sa description tant que la skill n'est pas utilisée, peut la charger de lui-même quand la tâche correspond, et vous pouvez aussi l'appeler avec /nom-de-la-skill.

Les subagents voient-ils ma conversation ?

Non. Chaque subagent démarre avec une fenêtre de contexte vierge : son propre prompt système, la tâche que Claude lui écrit, le CLAUDE.md et les skills que vous préchargez. Il renvoie un résumé à la conversation principale.

Qu'est-il arrivé aux commandes slash personnalisées ?

Elles ont été fusionnées dans les skills. Un fichier .claude/commands/deploy.md et une skill dans .claude/skills/deploy/SKILL.md créent tous deux /deploy. Les anciens fichiers de commandes continuent de fonctionner.

Peut-on utiliser les deux en même temps ?

Oui, dans les deux sens. Un subagent peut précharger des skills via son champ skills, et une skill avec context: fork s'exécute dans un subagent plutôt que dans la conversation principale.