mdskills
← Documentation

Comment installer des Skills d'agents

Les skills sont simplement des dossiers contenant un fichier SKILL.md. Les installer consiste à placer ce dossier au bon endroit pour votre agent. Voici où se trouve cet endroit pour chaque outil.

L'approche universelle

Chaque agent lit les skills depuis un répertoire spécifique. Il existe deux portées :

Skills de projet

Situés dans votre dépôt. Versionnés dans le contrôle de source. Accessibles à toute personne travaillant sur le projet.

Skills personnels

Situés dans votre répertoire personnel. Disponibles dans tous vos projets. Vous seul pouvez les utiliser.

Télécharger et enregistrer manuellement

L'approche la plus simple — aucun outil CLI nécessaire :

  1. Trouvez un skill sur mdskills.ai et cliquez sur le bouton Télécharger sur sa page de détail.
  2. Créez le dossier du skill dans votre projet. Par exemple, pour Claude Code :
    mkdir -p .claude/skills/my-skill
  3. Enregistrez le fichier sous SKILL.md dans ce dossier :
    mv ~/Downloads/SKILL.md .claude/skills/my-skill/
  4. Redémarrez votre agent (ou démarrez une nouvelle session). Le skill est maintenant disponible.

Le nom du dossier devient le nom du skill. Un dossier appelé review-pr devient la commande /review-pr dans les agents qui supportent les commandes slash.

Où enregistrer ? Consultez le guide agent par agent ci-dessous pour connaître le chemin exact du répertoire pour votre outil. En résumé : la plupart des agents utilisent .{agent}/skills/{name}/SKILL.md à la racine de votre projet.

Installation rapide avec le CLI

Le moyen le plus rapide d'installer n'importe quel skill depuis un dépôt GitHub :

# Install from mdskills.ai
npx mdskills install <skill-name>
# Or use the Vercel CLI
npx skills add <owner>/<repo>
# Or install manually — just clone and copy
git clone https://github.com/owner/skills-repo.git
cp -r skills-repo/my-skill .claude/skills/

Les outils CLI détectent vos agents installés et placent les skills dans les bons répertoires automatiquement. Mais vous n'avez pas besoin d'un CLI — copier le dossier manuellement fonctionne tout aussi bien.

Configuration agent par agent

Claude Code

Docs
Projet :.claude/skills/<skill-name>/SKILL.md
Personnel :~/.claude/skills/<skill-name>/SKILL.md

Claude Code offre le support le plus complet des skills. Les skills apparaissent comme des commandes slash — un skill nommé review-pr devient /review-pr. Claude charge aussi les skills automatiquement quand votre requête correspond à la description d'un skill.

Si vous avez des fichiers existants dans .claude/commands/, ils fonctionnent toujours. Les skills sont le format le plus récent et supportent des fonctionnalités supplémentaires comme les scripts intégrés et la configuration par frontmatter.

Claude Code supporte aussi les plugins, qui peuvent regrouper plusieurs skills avec des serveurs MCP et d'autres extensions. Installez les plugins via /plugins dans le CLI.

Cursor

Docs
Projet :.cursor/skills/<skill-name>/SKILL.md
Personnel :~/.cursor/skills/<skill-name>/SKILL.md

Cursor a lancé sa marketplace en février 2026 avec le support des skills dans son système de plugins. Les skills sont l'un des cinq primitifs de plugins aux côtés des serveurs MCP, sous-agents, hooks et règles.

Vous pouvez aussi placer des skills dans .agents/skills/ — ce chemin est reconnu par plusieurs agents et constitue un bon choix si votre équipe utilise différents outils.

VS Code (Copilot)

Docs
Projet :.github/skills/<skill-name>/SKILL.md
Personnel :~/.copilot/skills/<skill-name>/SKILL.md

VS Code supporte les skills d'agents via GitHub Copilot. Les skills vont dans .github/skills/ pour les skills de projet, ce qui signifie qu'ils sont automatiquement versionnés avec votre code.

VS Code reconnaît aussi .claude/skills/ et .agents/skills/. Vous pouvez configurer des chemins de recherche supplémentaires avec le paramètre chat.agentSkillsLocations.

Tapez / dans le chat Copilot pour voir les skills disponibles et les invoquer directement.

OpenAI Codex

Docs
Projet :.agents/skills/<skill-name>/SKILL.md
Personnel :~/.agents/skills/<skill-name>/SKILL.md

Codex utilise le répertoire .agents/skills/ par défaut. C'est le chemin indépendant du fournisseur que plusieurs agents reconnaissent, ce qui en fait un choix sûr si vous publiez des skills devant fonctionner avec différents outils.

Gemini CLI

Docs
Projet :.gemini/skills/<skill-name>/SKILL.md
Personnel :~/.gemini/skills/<skill-name>/SKILL.md

Gemini CLI lit aussi depuis .agents/skills/ en secours. Si vous ciblez Gemini CLI spécifiquement, utilisez le chemin .gemini/skills/. Pour la compatibilité multi-agents, utilisez .agents/skills/.

Compatibilité multi-agents

Si vous publiez un skill et voulez qu'il fonctionne partout, utilisez le chemin .agents/skills/. La plupart des agents vérifient ce répertoire en secours. Pour des skills spécifiques à un projet où toute l'équipe utilise le même outil, utilisez le chemin propre au fournisseur.

Astuce : Vous pouvez avoir le même skill dans plusieurs répertoires. Certaines équipes créent des liens symboliques entre les chemins pour que les skills fonctionnent quel que soit l'agent utilisé. Un simple ln -s fait l'affaire.

Vérifier que ça fonctionne

Après avoir installé un skill, vérifiez que votre agent le détecte :

  • Claude Code : Demandez « Quels skills sont disponibles ? » ou tapez / pour voir les skills dans le menu d'autocomplétion.
  • VS Code : Tapez / dans le panneau de chat Copilot.
  • Tout agent : Demandez « As-tu un skill pour [tâche] ? » et vérifiez s'il reprend la description.

Si le skill n'apparaît pas, vérifiez la structure des dossiers. Le répertoire doit contenir un fichier SKILL.md (la casse compte).