Accueil › Claude Cowork › Skills

Claude Cowork Skills : créer, installer et utiliser les Agent Skills

Les Agent Skills sont des modules d’instructions que Claude charge automatiquement pour devenir spécialiste d’une tâche : création de documents Office, workflows métier, analyses financières ou tout processus personnalisé que vous encodez dans un fichier SKILL.md.

Qu’est-ce qu’un Agent Skill ?

Un Skill est un dossier d’instructions, de scripts et de ressources que Claude découvre et charge dynamiquement quand une tâche le nécessite. C’est l’équivalent d’un guide d’intégration que vous rédigeriez pour un nouveau collaborateur, sauf que le collaborateur est un agent IA.

La différence avec un prompt classique est fondamentale. Un prompt est une instruction ponctuelle, valable pour une seule conversation. Un Skill est persistant, réutilisable et se déclenche automatiquement quand le contexte le demande. Vous n’avez pas besoin de le ré-expliquer à chaque session.

L’analogie la plus juste : les prompts donnent des directives, les Skills donnent de l’expertise. Quand vous demandez à Cowork de créer un Excel, le Skill xlsx se charge automatiquement. Il contient les instructions précises pour générer des formules fonctionnelles, des mises en forme conditionnelles et des graphiques. Sans ce Skill, Claude produirait un fichier correct mais basique. Avec le Skill, il produit un livrable professionnel.

Comment les Skills fonctionnent dans Cowork

Chargement progressif (Progressive Disclosure)

Le mécanisme central des Skills est le chargement progressif. Claude ne charge pas tous les Skills installés d’un coup (ce qui saturerait la fenêtre de contexte). Le processus se déroule en trois étapes :

Premièrement, la découverte : Claude voit uniquement le frontmatter YAML (nom et description) de chaque Skill installé. C’est léger, quelques dizaines de tokens par Skill.

Deuxièmement, le déclenchement : quand une tâche correspond à la description d’un Skill, Claude lit le fichier SKILL.md complet. Les instructions détaillées entrent alors en contexte.

Troisièmement, le chargement des ressources : au fil de l’exécution, Claude accède aux fichiers complémentaires (scripts, templates, références) uniquement quand il en a besoin.

Ce système permet d’installer des dizaines de Skills sans impact sur les performances. Seul le contenu pertinent consomme des tokens.

Déclenchement automatique vs slash commands

Les Skills se déclenchent de deux façons. Le déclenchement automatique est le plus courant : Claude analyse votre demande, compare avec les descriptions des Skills installés, et charge le bon Skill sans intervention. Demandez « crée un PowerPoint résumant ces données » et le Skill pptx se charge tout seul.

L’alternative est la slash command. Tapez / ou cliquez sur le bouton « + » dans Cowork pour voir la liste des Skills disponibles. Utile quand vous voulez forcer l’utilisation d’un Skill spécifique ou quand la détection automatique ne se déclenche pas.

Exécution dans la VM

Les Skills s’exécutent dans l’environnement de machine virtuelle de Cowork. Ils ont accès au système de fichiers local (dans les dossiers autorisés), peuvent exécuter du code Python ou JavaScript, et produire des fichiers directement sur votre disque. C’est ce qui distingue les Skills des simples prompts : ils ne se contentent pas de guider Claude, ils lui donnent les outils pour agir.

Skills natifs d’Anthropic

Cowork est livré avec un ensemble de Skills pré-construits par Anthropic pour les tâches documentaires courantes. Ils se chargent automatiquement, sans configuration.

Ces Skills natifs sont disponibles sur claude.ai, dans Cowork, dans Claude Code et via l’API Claude. Ils suivent le même format que les Skills personnalisés : un dossier avec un SKILL.md. La différence est qu’ils sont maintenus par Anthropic et bénéficient de mises à jour régulières.

Anatomie d’un Skill : le fichier SKILL.md

Un Skill est techniquement un dossier contenant au minimum un fichier SKILL.md. Ce fichier a deux parties : le frontmatter YAML (métadonnées) et le contenu Markdown (instructions).

Le frontmatter YAML

Le frontmatter est la carte d’identité du Skill. Il se place entre deux lignes --- au début du fichier. Deux champs sont obligatoires :

---
name: mon-skill
description: Description claire de ce que fait ce Skill et quand l'utiliser.
---

Le champ name devient la slash command (/mon-skill). Il doit contenir uniquement des lettres minuscules, des chiffres et des tirets, avec un maximum de 64 caractères. Les mots réservés « anthropic » et « claude » sont interdits.

Le champ description est crucial : c’est lui que Claude lit pour décider s’il doit charger le Skill. Une description trop vague signifie des déclenchements manqués. Une description trop large signifie des déclenchements parasites. Soyez précis sur le « quand utiliser » : listez les mots-clés déclencheurs, les types de demandes concernés et les contextes d’usage.

Le contenu Markdown

Sous le frontmatter, vous écrivez les instructions en Markdown standard. C’est le cœur du Skill : les étapes à suivre, les bonnes pratiques, les exemples, les erreurs à éviter. Structurez avec des titres H2/H3, utilisez des listes pour les étapes séquentielles, et incluez des exemples concrets.

---
name: rapport-hebdo
description: Génère le rapport hebdomadaire d'activité au format de 
l'entreprise. Utiliser quand on demande un rapport, un weekly update, 
un bilan de la semaine.
---

# Rapport hebdomadaire

## Format attendu
1. Résumé exécutif (3 phrases max)
2. Réalisations de la semaine (bullet points)
3. Blocages et risques
4. Priorités semaine suivante
5. Métriques clés (tableau)

## Ton et style
- Direct, factuel, pas de langue de bois
- Chiffres avant les commentaires
- Maximum 1 page A4

## Exemples
[Inclure un exemple de rapport type]

Fichiers de ressources complémentaires

Un Skill peut inclure bien plus qu’un seul fichier Markdown. La structure type d’un Skill avancé :

mon-skill/
├── SKILL.md              # Instructions principales
├── references/
│   ├── guidelines.md     # Documentation détaillée
│   └── examples.md       # Exemples référence
├── scripts/
│   ├── analyze.py        # Script Python exécutable
│   └── template.js       # Template JavaScript
└── templates/
    └── report-template.md # Template de document

Le principe est de garder le SKILL.md focalisé sur les instructions essentielles et de déplacer le contenu de référence dans des sous-dossiers. Claude les charge à la demande, quand le SKILL.md y fait référence. Par exemple : « Pour le format de confidentialité, consultez references/checklist.txt. »

Créer votre premier Skill personnalisé

Méthode manuelle

La méthode la plus directe pour créer un Skill :

Créez un dossier dans le répertoire de Skills de Cowork. L’emplacement par défaut est ~/.claude/skills/votre-skill/ pour les Skills personnels qui fonctionnent sur tous vos projets.

Créez un fichier SKILL.md dans ce dossier avec le frontmatter YAML et vos instructions.

Testez le Skill en lançant une tâche Cowork qui correspond à sa description. Vérifiez que Claude le détecte et le charge automatiquement. Vous pouvez aussi forcer le chargement avec la slash command /votre-skill.

Itérez : observez comment Claude utilise le Skill, identifiez les cas non couverts, affinez les instructions. Les meilleurs Skills sont le résultat de plusieurs cycles d’amélioration.

Méthode assistée par Claude

Utilisez le Skill natif skill-creator pour accélérer la création. Tapez /create-skill dans Cowork et décrivez ce que vous voulez (par exemple : « un Skill pour générer des notes de réunion au format de mon entreprise »). Claude vous pose des questions de clarification, puis génère la structure complète : dossier, SKILL.md formaté, et ressources éventuelles.

Vous pouvez aussi extraire un Skill à partir d’une conversation existante. Après une session Cowork où vous avez itéré sur un workflow, demandez : « crée un Skill à partir de ce qu’on vient de faire ». Claude capture la procédure en Skill réutilisable.

Upload via les paramètres Claude

Pour les Skills téléchargés depuis la communauté ou reçus d’un collègue : allez dans Paramètres > Capacités > Skills dans Claude Desktop, et uploadez le dossier (zippé si nécessaire). Le Skill devient disponible dans Chat, Cowork et l’onglet Code.

Bonnes pratiques pour des Skills efficaces

Soignez la description

La description dans le frontmatter est le facteur n°1 de fiabilité d’un Skill. Claude l’utilise pour décider du déclenchement. Incluez des mots-clés concrets que l’utilisateur emploierait naturellement. Par exemple, pour un Skill de communications internes : « Utiliser quand on demande un status report, un 3P update, un newsletter d’entreprise, un weekly update, une communication interne. »

Gardez le SKILL.md focalisé

Un SKILL.md trop long se comporte de manière imprévisible. Anthropic recommande de garder le fichier principal concis et de déplacer le contenu détaillé dans des fichiers de référence (references/). Le chargement à la demande gère l’optimisation des tokens automatiquement.

Incluez des exemples concrets

Les exemples de résultats attendus sont plus efficaces que des instructions abstraites. Montrez un extrait de l’output souhaité plutôt que de le décrire en termes généraux. Claude calibre sa sortie sur les exemples fournis.

Itérez avec Claude

Demandez à Claude de capturer ses approches réussies dans le Skill. Après une session qui a produit un bon résultat, dites « mets à jour le Skill rapport-hebdo avec l’approche qu’on vient d’utiliser ». Le Skill s’améliore au fil du temps, comme un collaborateur qui apprend vos préférences.

Pensez composabilité

Claude peut charger plusieurs Skills simultanément. Votre Skill doit fonctionner en combinaison avec d’autres, pas en isolation. Évitez les instructions qui supposent que votre Skill est le seul actif. Par exemple, un Skill de charte graphique et un Skill de rapport financier doivent pouvoir coexister dans la même session.

Skills vs Plugins : quelle différence ?

La confusion entre Skills et Plugins est fréquente. Voici la distinction nette.

Un Skill est une unité d’expertise : un fichier SKILL.md qui enseigne à Claude comment faire une chose spécifique. C’est une instruction individuelle.

Un Plugin est un toolkit complet : il regroupe plusieurs Skills, des connecteurs (intégrations à des services externes), des slash commands et des sub-agents dans un seul paquet. Un plugin « Sales » contient par exemple des Skills pour la prospection, la préparation d’appels et le suivi de pipeline, plus les connecteurs CRM nécessaires.

En pratique : utilisez des Skills individuels pour des tâches précises et récurrentes. Utilisez des Plugins quand vous avez besoin d’un ensemble cohérent d’outils pour un rôle entier.

Les 11 plugins natifs d’Anthropic

Anthropic a open-sourcé 11 plugins construits pour les rôles métier courants, disponibles sur GitHub (anthropics/knowledge-work-plugins). Ils sont installables directement depuis Cowork.

Chaque plugin est un point de départ. L’intérêt réel est de le personnaliser pour vos outils, votre terminologie et vos processus internes. Cliquez « Customize » sur un plugin installé, et Claude vous guide dans l’adaptation.

L’écosystème communautaire des Skills

Au-delà des Skills et plugins officiels, un écosystème communautaire s’est développé rapidement depuis le lancement de Cowork.

Répertoires principaux

anthropics/skills sur GitHub : le répertoire officiel d’Anthropic avec les Skills document (docx, xlsx, pptx, pdf) plus des exemples créatifs et techniques.

anthropics/knowledge-work-plugins : les 11 plugins métier open-source d’Anthropic.

La bibliothèque Antigravity Awesome Skills regroupe plus de 1 200 Skills universels compatibles avec Claude Code, Cowork, Cursor, Gemini CLI et Codex CLI. Installation possible en une commande via npx.

Des plateformes comme SkillHub (skillhub.club) proposent plus de 7 000 Skills évalués par IA avec scores de qualité et installation en un clic depuis l’app Desktop.

Le site skills.sh (écosystème Vercel) offre un répertoire avec leaderboard et installeur CLI (npx skills add).

Un standard ouvert et portable

Le format Agent Skills est un standard ouvert, documenté sur agentskills.io. Anthropic l’a conçu pour être portable : le même fichier SKILL.md fonctionne dans Claude Code, Cowork, et dans des outils tiers comme Cursor, Windsurf, Gemini CLI et Codex CLI. Les Skills ne sont pas verrouillés à l’écosystème Claude, bien que certains exploitent des capacités spécifiques à la plateforme (accès VM, exécution de code).

Cette portabilité est un avantage stratégique : si vous investissez du temps à créer des Skills pour votre équipe, ils resteront utilisables même si vous changez d’outil.

Utiliser les Skills via l’API Claude

Les Skills ne sont pas réservés à l’interface Desktop. L’API Claude permet d’intégrer les Skills dans vos applications programmatiques.

Skills pré-construits via l’API

Les Skills natifs (xlsx, pptx, docx, pdf) s’utilisent en spécifiant le skill_id dans le paramètre container de l’API Messages, conjointement avec l’outil d’exécution de code. Vous pouvez combiner jusqu’à 8 Skills par requête.

"container": {
  "skills": [
    {
      "type": "anthropic",
      "skill_id": "xlsx",
      "version": "latest"
    }
  ]
}

Skills personnalisés via l’API

L’API Skills (/v1/skills) permet d’uploader, lister, versionner et supprimer vos Skills personnalisés. Le Skill uploadé est partagé à l’échelle de l’organisation et peut être référencé dans les requêtes Messages avec "type": "custom".

L’utilisation de l’API requiert les headers beta suivants : code-execution-2025-08-25 et skills-2025-10-02. Les Skills custom sont versionnés : chaque mise à jour crée une nouvelle version, et vous pouvez spécifier une version précise ou utiliser "latest".

Distribution des Skills en entreprise

Marketplace privé

Les plans Team et Enterprise permettent aux administrateurs de créer des marketplaces de plugins privés. Depuis les paramètres d’organisation, un admin peut ajouter des plugins manuellement (upload de fichiers .zip) ou connecter un dépôt GitHub privé pour une synchronisation automatique.

Les options de distribution sont granulaires : auto-installation pour tous les membres, disponible en self-service dans le catalogue, ou masqué. L’admin contrôle qui voit quoi, et peut pousser automatiquement des plugins spécifiques vers certaines équipes.

Synchronisation GitHub

Pour les équipes qui développent des plugins/skills en interne, la synchronisation GitHub est le workflow recommandé. Connectez un dépôt GitHub privé (hébergé sur github.com, pas sur un GitHub Enterprise Server custom), et Cowork synchronise automatiquement les plugins. Chaque push déclenche une comparaison avec le dernier état synchronisé. Les plugins sont remplacés intégralement à chaque sync.

Skills partagés vs plugins gérés

Distinction importante : les Skills uploadés via les paramètres Claude Desktop sont partagés entre Chat, Cowork et l’onglet Code. Les plugins installés dans Cowork restent dans Cowork (et inversement pour l’onglet Code). Les plugins gérés par l’organisation ne sont pas éditables par les membres individuels, ce qui garantit la cohérence.

Skills en action : du Chat au Cowork

Les Skills dans le Chat sont utiles. Les Skills dans Cowork sont opérationnels. La différence est fondamentale.

Dans le Chat, un Skill de charte graphique influence une réponse. Dans Cowork, ce même Skill gouverne chaque fichier que Claude crée de manière autonome. Un Skill d’écriture ne façonne pas juste un brouillon : il gouverne chaque article que Claude rédige pendant une session autonome de 30 minutes.

Exemples concrets de Skills combinés dans Cowork :

Un Skill « rapport financier » + le Skill natif xlsx + un connecteur FactSet : Claude récupère les données de marché, génère un classeur Excel avec analyse de ratios, et produit un mémo Word récapitulatif. Le tout en une session autonome.

Un Skill « compte-rendu de réunion » + le Skill natif docx : Claude analyse une transcription, extrait les décisions et actions, et produit un document Word au format de votre entreprise.

Un Skill « préparation client » + le plugin Sales + un connecteur CRM : Claude recherche les informations sur un prospect, compile un briefing et prépare des slides de présentation.

Sécurité des Skills

Les Skills sont puissants, ce qui signifie qu’un Skill malveillant peut être dangereux. Anthropic est clair sur les risques : un Skill malicieux peut diriger Claude vers des actions non prévues, exfiltrer des données ou accéder à des ressources non autorisées.

Règles de sécurité

N’installez que des Skills de sources de confiance : ceux que vous avez créés vous-même ou obtenus d’Anthropic. Avant d’utiliser un Skill tiers, auditez l’intégralité des fichiers : SKILL.md, scripts, images, et toute ressource incluse. Cherchez les patterns suspects : appels réseau inattendus, accès à des fichiers non liés au Skill, opérations qui ne correspondent pas à la description.

Minimisez les données personnelles dans les fichiers de ressources. Un Skill n’a pas besoin de contenir vos identifiants ou données clients pour fonctionner.

Protection par la sandbox

La VM de Cowork limite l’impact d’un Skill compromis. Même si un Skill malveillant tente d’accéder à des fichiers hors du dossier autorisé, la sandbox bloque l’opération. Le réseau est aussi restreint par défaut. Cela ne rend pas les Skills invulnérables, mais réduit significativement la surface d’attaque.