Comment synchroniser vos skills dans Claude Code, Codex, Cursor et OpenCode

Où chaque outil cherche

D'après la documentation de chaque outil, lue le 4 novembre 2026. Chaque dossier contient un sous-dossier par skill, avec un SKILL.md à l'intérieur.

Deux dossiers couvrent les quatre : ~/.claude/skills (Claude Code, Cursor, OpenCode) et ~/.agents/skills (Codex, Cursor, OpenCode).

Une seule copie sur votre machine : les liens symboliques

Gardez les vrais fichiers dans un seul dossier et faites pointer les deux emplacements vers lui. Sous macOS ou Linux :

mkdir -p ~/skills
# move existing skills in first, then:
ln -s ~/skills ~/.claude/skills
ln -s ~/skills ~/.agents/skills

Si l'un des dossiers existe déjà, déplacez son contenu dans ~/skills et supprimez le dossier vide avant de créer le lien. Cursor et OpenCode lisent les deux emplacements : ils atteignent donc les mêmes fichiers par deux chemins. Si l'un d'eux affiche une skill en double, il s'agit toujours d'un seul fichier : modifiez-le une fois dans ~/skills.

Pour un dépôt, faites de même avec .claude/skills et .agents/skills, commitez le vrai dossier, et toutes les personnes qui clonent le dépôt obtiennent les skills.

Une seule copie pour l'équipe : un serveur MCP

Liens symboliques et dépôts conviennent aux développeurs. Ils n'atteignent pas le collègue qui travaille dans Claude ou ChatGPT depuis le navigateur, et ils demandent un git pull pour se mettre à jour. Les quatre agents de code se connectent aussi à des serveurs MCP distants :

• Claude Code : claude mcp add --transport http <name> <url>
• Codex : une entrée de serveur avec url = "…" dans sa configuration (Streamable HTTP).
• Cursor : un serveur Streamable HTTP dans ses réglages MCP.
• OpenCode : un serveur avec "type": "remote" dans sa configuration.

Un serveur qui contient les skills de l'équipe donne aux agents de code, à Claude et à ChatGPT la même copie à jour, sans rien à récupérer ni à relier.

Vérifier qu'un outil voit votre skill

1. Vérifiez la structure : <folder>/<skill-name>/SKILL.md, avec un dossier qui porte le même nom que le champ name.
2. Vérifiez le frontmatter : un name en lettres minuscules, chiffres et tirets, de 64 caractères au maximum, et une description non vide. Le convertisseur SKILL.md écrit les deux.
3. Ouvrez une nouvelle session et demandez à l'agent quelles skills il a, ou demandez la tâche que nomme la description.

Questions

Comment synchroniser les skills de Claude Code avec Claude Desktop et claude.ai ?

Claude Code lit des dossiers sur le disque ; Claude Desktop et claude.ai gardent les skills importées dans votre compte. Importez le même dossier en ZIP sous Customize > Skills, ou connectez les deux à un seul serveur MCP qui sert les skills.

Pourquoi Claude Code ne voit-il pas mon dossier .agents/skills ?

Claude Code lit ~/.claude/skills et .claude/skills, pas .agents/skills. Liez le dossier dans ~/.claude/skills, comme dans les étapes sur les liens symboliques ci-dessus.