Claude Code Sous-agents Ne Chargent Pas les Compétences dans les Systèmes Multi-Agents

Problème de chargement des compétences multi-agents dans Claude Code

Un développeur créant un système multi-agents dans Claude Code v2.1.91 a identifié une limitation critique : les sous-agents ne peuvent pas accéder aux compétences définies dans le répertoire .claude/skills/, alors que la session principale charge parfaitement les compétences avec des mots-clés déclencheurs, le contenu complet des compétences dans le contexte, et les contrôles de qualité respectés.

Détails du problème

Lors du lancement d'un sous-agent via l'outil Agent en utilisant subagent_type, l'agent n'a aucun accès aux compétences. Le développeur a testé six approches :

• skills: dans le frontmatter de l'agent - documenté comme "le contenu complet de la compétence est injecté au démarrage" mais n'a aucun effet
• Skill dans la liste tools: - non reconnu, l'outil Skill n'est pas disponible pour les sous-agents
• Drapeau CLI --agent myagent - même résultat, les compétences ne sont pas chargées
• Équipes d'agents (TeamCreate) - même résultat
• Chargement de la compétence nativement dans la session parent, puis lancement de l'agent - l'agent n'hérite pas du contexte parent
• Même les compétences natives de Claude (frontend-design, claude-api) ne sont pas disponibles pour les sous-agents

Exemple de configuration

La structure du fichier agent :

---
name: Sales
description: "Agent commercial"
model: opus
skills:
- outreach
- validator
tools:
- Bash
- Read
- Write
- WebSearch
---

Les compétences existent dans .claude/skills/outreach/SKILL.md avec un frontmatter approprié et fonctionnent parfaitement dans la session principale.

Impact

Cette limitation rend l'architecture multi-agents "inutile pour tout ce qui nécessite des connaissances spécifiques" selon le développeur. Les agents produisent des résultats nettement moins bons car ils ne peuvent que Read les fichiers de compétences (ce qui les charge comme contenu de chat, pas comme instructions système). La différence de qualité entre la session principale (compétences chargées nativement) et le sous-agent (compétences lues comme markdown) est décrite comme "énorme".

Le développeur exécute Claude Code 2.1.91 sur macOS et demande si quelqu'un a réussi à utiliser skills: dans le frontmatter d'un agent personnalisé, ou s'il s'agit d'une limitation connue, d'un bug ou d'une erreur de configuration.