Documentation

Que sont les Claude Agent Skills ?

Une Claude Agent Skill est un fichier SKILL.md qui enseigne à Claude une expertise métier, des conventions, des workflows et des bonnes pratiques — le tout en texte brut.

Comment fonctionnent les Skills

  1. 1 Placez un fichier SKILL.md dans votre projet (ou dans le répertoire ~/.claude/skills/).
  2. 2 Claude le lit au début de chaque session — assimilant les connaissances sans prompts répétés.
  3. 3 Les Skills utilisent le chargement différé : Claude voit d'abord le nom et la description, puis lit le fichier complet seulement si c'est pertinent — économisant des tokens.

Exemples

  • Une skill Laravel qui connaît l'architecture, les conventions de nommage et les patterns courants de votre app.
  • Une skill d'audit de sécurité avec des checklists OWASP et des procédures de revue de code.
  • Une skill de charte éditoriale pour que Claude écrive toujours avec la voix de votre entreprise.

Chargement différé

Les Skills sont économes en tokens. Claude voit d'abord uniquement le nom et une description d'une ligne. Il ne lit le SKILL.md complet que lorsque la tâche en cours est pertinente — vous pouvez donc avoir de nombreuses Skills sans surcharger le contexte.

Skills vs outils MCP

Les Skills et les outils MCP (Model Context Protocol) sont complémentaires — ils résolvent des problèmes différents.

Skills

  • Apportent connaissances, expertise et workflows
  • Texte brut — aucune exécution de code
  • Fonctionnent sur web, desktop et CLI
  • Idéal pour : conventions, savoir métier, style rédactionnel

Outils MCP

  • Se connectent aux APIs, bases de données et outils externes
  • Exécutent du code et effectuent des appels réseau
  • Nécessitent desktop ou CLI (pas web)
  • Idéal pour : données temps réel, opérations fichiers, intégrations