How to Build Claude Subagents Better Than 99% of People

How to Build Claude Subagents Better Than 99% of People

🎙 Nate Herk 👥 964K 📅 9 juin 2026 ⏱ 26 min 👁 74K 📄 tutoriel 🧭 2026-08-28
Disponible en : Français (actuel) English

Mots-clés

subagentClaude Codecontext windowYAML front matterprogressive disclosure

Résumé

La vidéo de Nate Herk, intitulée ‘How to Build Claude Subagents Better Than 99% of People’, est un tutoriel pratique dédié à l’utilisation avancée des subagents dans Claude Code, l’outil de programmation assistée par IA d’Anthropic. L’auteur commence par définir ce qu’est un subagent : un agent secondaire lancé par l’agent principal pour exécuter des tâches spécifiques dans un contexte propre, préservant ainsi la fenêtre de contexte principale. Il distingue les subagents intégrés (comme le ‘researcher’) des subagents personnalisés, qui sont des fichiers Markdown contenant un front matter YAML (nom, description, modèle, outils, etc.) et des instructions. Il explique le concept de ‘progressive disclosure’ : Claude Code lit d’abord le nom et la description pour décider si le subagent doit être invoqué, ce qui économise des tokens. Il compare les subagents aux ‘skills’ (compétences) : les deux sont des fichiers Markdown, mais les subagents offrent un contexte propre et peuvent être exécutés en parallèle, tandis que les skills sont généralement utilisés dans la session principale. Il aborde également la distinction entre subagents de projet (dans le dossier .claude du projet) et globaux (au niveau utilisateur). La partie centrale de la vidéo est une démonstration en direct de la création d’un subagent personnalisé (‘plan roaster’) via l’interface de Claude Code, avec choix des outils (lecture seule), du modèle (Haiku) et de la couleur. Il montre comment itérer sur la description pour améliorer le déclenchement automatique, en corrigeant notamment une erreur de syntaxe YAML. Il souligne l’importance de descriptions précises pour éviter les ‘misfires’ (déclenchements indésirables ou manqués). Enfin, il recommande de concevoir des subagents spécialisés (sécurité, tests, documentation, etc.) et de s’inspirer de référentiels communautaires comme ‘awesome Claude Code subagents’, tout en mettant en garde contre les risques de prompt injection lors du téléchargement de fichiers externes.

296 mots

Évaluation critique

Valeur des informations & solidité de l’argumentation

La valeur des informations est élevée pour un public technique : la vidéo fournit des explications concrètes et des démonstrations en direct de l’utilisation des subagents, ce qui est rare et précieux. L’auteur s’appuie sur son expérience pratique et montre des exemples réels de configuration et de dépannage. L’argumentation est solide : il justifie l’utilisation des subagents par des avantages concrets (économie de tokens, parallélisation, spécialisation) et illustre chaque point avec des exemples. Il aborde également les pièges courants (mauvaise description, conflits entre skills et subagents, erreurs de syntaxe) et propose des méthodes d’itération, ce qui renforce la crédibilité du contenu.

Rigueur scientifique, qualité des sources, adéquation du titre

La rigueur scientifique est limitée : il s’agit d’un tutoriel basé sur l’expérience personnelle, sans références à des études ou à la documentation officielle d’Anthropic (bien que l’auteur mentionne la documentation, il ne fournit pas de lien direct). Les sources citées dans la description sont principalement des liens vers ses propres cours, outils et réseaux sociaux, ce qui est pertinent pour le contexte mais ne constitue pas des références scientifiques. Le titre est en adéquation avec le contenu : il promet un guide pour construire des subagents mieux que 99% des gens, et la vidéo tient cette promesse en offrant des conseils détaillés et des démonstrations. La qualité des sources est donc moyenne, mais acceptable pour un contenu de type tutoriel.

237 mots

Adéquation titre / contenu

Le titre correspond bien au contenu : la vidéo explique en détail comment créer et utiliser des subagents Claude Code, avec des démonstrations pratiques et des conseils pour les optimiser.

Qualité & fiabilité

7/10

Le contenu est un tutoriel pratique basé sur l'expérience directe de l'auteur avec Claude Code. Les explications sont claires et détaillées, mais reposent principalement sur des démonstrations personnelles et des retours d'usage, sans validation scientifique externe. La fiabilité est bonne pour un usage pratique, mais limitée par l'absence de références académiques ou de tests contrôlés.

Chapitres

Sources citées

Sources concordantes

Apport & nouveautés

La vidéo apporte une valeur ajoutée en proposant une méthode pratique et itérative pour créer des subagents efficaces, en insistant sur l’importance de la description (front matter) pour le déclenchement automatique. Elle met en lumière des astuces peu connues comme la possibilité de définir des outils interdits (lecture seule), de choisir un modèle différent pour chaque subagent, et d’utiliser des couleurs pour visualiser les agents. L’accent mis sur la spécialisation et la délégation en parallèle est une perspective utile pour optimiser les coûts et la qualité.

Pour aller plus loin :

  • Documentation officielle de Claude Code sur les subagents — Référence officielle pour configurer les subagents.
  • Awesome Claude Code Subagents (GitHub) — Collection de subagents communautaires, mentionnée dans la vidéo.
  • Progressive Disclosure (concept UX) — Concept de design expliquant la divulgation progressive, appliqué ici au front matter.
  • Prompt injection (OWASP) — Risque de sécurité mentionné lors du téléchargement de subagents externes.

151 mots

Profil radar

Le profil radar montre des scores élevés en quantité d'information et en niveau technique, reflétant un contenu dense et spécialisé. La fiabilité globale est légèrement inférieure, ce qui est cohérent avec un tutoriel basé sur l'expérience personnelle plutôt que sur des sources académiques.

Fiabilité 6/10