La réponse courte
- 1Placez le Skill dans
~/.cursor/skills/pour l’utiliser dans tous vos projets (c’est aussi le seul dossier synchronisable avec les Cloud Agents), ou dans.cursor/skills/pour un seul projet. - 2Le
namedeSKILL.mddoit correspondre au nom du dossier, avec uniquement des lettres minuscules, des chiffres et des tirets. - 3Retrouvez-le sous Customize → Skills. Exécutez-le avec
/skill-name, ou joignez-le à un message avec@skill-name. - 4Vous en voulez des tout prêts ? Parcourez les Skills Cursor à installer en une commande.
Où Cursor cherche les Skills
Cursor vérifie ses propres dossiers, le dossier partagé ~/.agents/skills/, ainsi que ceux de Claude Code et de Codex. Si vous utilisez déjà un autre agent, vos Skills sont peut-être déjà dans Cursor.
| Dossier | À quoi il sert |
|---|---|
~/.cursor/skills/ | Tous les projets. Le seul dossier synchronisé avec les Cloud Agents. |
~/.agents/skills/ | Tous les projets de cet ordinateur. Skillry installe ici, et Codex le lit aussi. |
.cursor/skills/ ou .agents/skills/ | Un projet, n’importe où dans le dépôt. Un dossier imbriqué s’applique aux fichiers qu’il contient. |
.claude/skills/, .codex/skills/ et leurs équivalents dans ~ | Lus pour que les Skills de Claude Code et de Codex fonctionnent aussi ici. |
Comment ajouter des Skills à Cursor
La CLI Skillry installe dans ~/.agents/skills/, que Cursor lit : aucune option n’est donc nécessaire. Si vous copiez un dossier à la main, placez-le plutôt dans ~/.cursor/skills/ ; c’est le dossier qui peut vous suivre dans les Cloud Agents.
- 1
Ouvrez le Skill sur Skillry, sélectionnez Copier le prompt d’installation, puis Copier dans la fenêtre.
- 2
Collez-le dans Cursor et envoyez-le. L’agent lit les instructions d’installation de Skillry et exécute lui-même la bonne commande.
Prompt d’installation Read https://skillry.dev/skills/<slug>/install.md and follow the instructions to install the skill. - 3
Quand votre navigateur vous demande d’approuver un code d’appareil, approuvez-le.
Vous devriez voir : Cursor indiquant la version installée et le dossier utilisé, sous
~/.agents/skills/.
- 1
Connectez-vous une fois. Une fenêtre de navigateur s’ouvre avec un code d’appareil à approuver.
Terminal npx --yes skillry-cli@latest login - 2
Installez. Aucune option n’est nécessaire, car le dossier par défaut de la CLI est celui que lit Cursor.
Terminal npx --yes skillry-cli@latest install <slug>Vous devriez voir :
Installed <slug> <version> to ~/.agents/skills/<slug>
Sélectionnez Télécharger le ZIP sur la page du Skill, ou utilisez un dossier de Skill obtenu ailleurs. Lisez SKILL.md et le contenu de scripts/ avant d’installer, car l’agent suit ces instructions et peut exécuter ces scripts. Déplacez ensuite le dossier entier :
mkdir -p ~/.cursor/skills
mv ~/Downloads/my-skill ~/.cursor/skills/Les ZIP se décompressent souvent avec un niveau en trop, comme my-skill/my-skill/SKILL.md. SKILL.md doit se trouver directement dans le dossier du Skill, sinon l’agent ne le trouvera pas.
Cursor cherche les Skills au démarrage. Après l’installation, ouvrez un nouveau chat ou rechargez la fenêtre, puis vérifiez Customize → Skills, dans le groupe Agent Decides.
La règle de nommage qui fait disparaître les Skills
Cursor ne charge un Skill que si le name de son SKILL.md correspond exactement au dossier qui le contient. En cas de différence, aucune erreur ne s’affiche. Le Skill n’est simplement pas là.
Pourquoi a-t-il disparu ?
Vous téléchargez launch-page, renommez le dossier en landing pour faire du rangement, et il disparaît de Cursor. Le dossier et le name ne correspondent plus. Redonnez au dossier son ancien nom, ou changez name en landing.
Un nom que Cursor accepte
- Uniquement des lettres minuscules, des chiffres et des tirets
- Identique au dossier qui contient
SKILL.md - Accompagné d’une
description
Comment exécuter un Skill dans Cursor
Dans le chat, tapez / et le nom du Skill, puis votre demande :
/launch-page Parcelo, a parcel-tracking dashboard for small online shopsPour garder un Skill actif pendant toute la session, choisissez-le dans le menu / et appuyez sur Option+Entrée (Mac) ou Alt+Entrée (Windows), ou choisissez Use as Mode. Il devient un Custom Mode et reste actif jusqu’à ce que vous en sortiez.
Utiliser les Skills dans les Cloud Agents
Les Cloud Agents ne s’exécutent pas sur votre ordinateur : ils ne reçoivent donc que les Skills que Cursor synchronise pour eux. Voici comment le configurer :
- 1Gardez le Skill dans
~/.cursor/skills/. Les Skills de projet et~/.agents/skills/restent sur votre machine. - 2Ouvrez Settings → Agents → Context and Tools et activez Sync Skills for Cloud Agents.
- 3Pour partager plutôt un Skill personnel avec votre équipe, ouvrez-le dans Customize → Skills et choisissez Publish.
Règles Cursor vs Skills
Les règles Cursor sont de courtes consignes que Cursor ajoute à la conversation, soit toujours, soit pour les fichiers correspondants. Un Skill est une procédure que l’agent ne charge que lorsque la tâche le demande. Utilisez les règles pour les conventions, et les Skills pour les tâches en plusieurs étapes.
Une procédure, à la demande
- Un dossier avec
SKILL.md - S’exécute quand il est pertinent, ou quand vous tapez
/name - Travail en plusieurs étapes, scripts, modèles
Des consignes dans le contexte
- Fichiers
.mdcdans.cursor/rules/(les fichiers.mdsimples sont ignorés) - Always Apply, Apply Intelligently, Apply to Specific Files ou Apply Manually
- Conventions courtes. Cursor lit aussi
AGENTS.mdetCLAUDE.md
Vous migrez d’anciennes règles ? La commande intégrée /migrate-to-skills de Cursor convertit les règles « Apply Intelligently » et les slash commands en Skills.
Votre Skill Cursor n’apparaît pas ? Essayez ceci
Vérifiez d’abord le nom. Une différence entre name et le dossier est la raison habituelle d’un Skill manquant dans Cursor.
Absent de Customize → Skills
Vérifiez que name correspond au dossier, puis ouvrez un nouveau chat ou rechargez la fenêtre.
Absent des Cloud Agents
Déplacez-le dans ~/.cursor/skills/ et activez la synchronisation.
Jamais choisi tout seul
Sa description ne correspond peut-être pas à votre façon de demander, ou paths le limite à d’autres fichiers.
Questions fréquentes
Quelle est la différence entre les règles Cursor et les Skills ?
Les règles sont des consignes que Cursor ajoute aux conversations, soit toujours, soit pour les fichiers correspondants. Les Skills sont des dossiers contenant une procédure que l’agent utilise quand elle est pertinente ou quand vous l’appelez.
Cursor peut-il utiliser les Claude Skills ?
Oui. Cursor lit ~/.claude/skills/ et .claude/skills/, à condition que le name de chaque Skill corresponde à son dossier.
Où sont stockés les Skills Cursor ?
~/.cursor/skills/ ou ~/.agents/skills/ pour tous les projets, et .cursor/skills/ ou .agents/skills/ pour un seul projet.
Les Skills fonctionnent-ils dans les Cursor Cloud Agents ?
Seulement les Skills de ~/.cursor/skills/, et seulement après avoir activé Sync Skills for Cloud Agents.
Sources
Ce guide vous a-t-il aidé ?
