Claude Skills vs Agent Skills vs Cursor Rules : les différences (2026)

1. Pourquoi Claude Skills, Agent Skills et Cursor Rules sont souvent confondus

De fin 2025 à 2026, les outils de code IA ont tous poussé des « configurations Agent versionnables » : Cursor avec .cursor/rules et .cursor/skills, Anthropic avec .claude/skills, la communauté avec agentskills.io comme standard multi-hôtes. Marketing et traductions répètent Skill et Agent — confusion typique :

• Une checklist de release en 30 étapes dans les Cursor Rules, milliers de tokens à chaque conversation ;
• Chercher un panneau « Rules » dans Claude Code alors que le produit parle de Skills ;
• Un SKILL.md partagé : .cursor ou .claude ?
• Croire qu’« Agent Skills » est un nouveau SaaS alors que c’est une spécification de fichiers.

Cause : couche produit, implémentation et standard se superposent dans le vocabulaire. Si vous avez lu AI Coding Workflow, Rules, Skills — guide complet, gardez-le comme architecture ; ici, c’est le tableau de correspondance + guide de décision.

Les solo devs tout mettent dans AGENTS.md ; les équipes peinent à revoir ce qui est Rule ou Skill. Les tableaux ci-dessous donnent un langage commun en PR : « est-ce une contrainte permanente ou un runbook ? »

2. Définitions (What)

2.1 Cursor Rules — couche de contraintes toujours chargée

Cursor Rules sont la politique permanente de Cursor : injectée automatiquement à l’ouverture d’un projet correspondant. Emplacements : .cursor/rules/*.mdc, Rules utilisateur, AGENTS.md à la racine. Idéal pour diff minimal, répertoires interdits, langue de réponse, tests obligatoires, pas de force push — court, ferme, valable à chaque échange. La doc insiste : pas de long runbook ici.

2.2 Claude Skills — runbook à la demande dans Claude Code

Claude Skills (Claude Code Skills) sont des paquets de capacités dans l’agent terminal/IDE Anthropic : .claude/skills/<name>/SKILL.md (aussi au niveau utilisateur). L’agent lit d’abord description dans le frontmatter, charge le corps si l’intention correspond, exécute review, release, audit sécurité, etc. Appel explicite /skill-name ; disable-model-invocation évite les déclenchements accidentels. Approfondir : guide Claude Code Skills — framework en 10 points.

2.3 Agent Skills — standard ouvert SKILL.md multi-outils

Agent Skills n’est pas un interrupteur vendor : c’est la Agent Skills Specification — frontmatter SKILL.md (name, description…), corps runbook, references/ et scripts optionnels. Cursor, Claude Code et d’autres hôtes parsent la même convention ; une équipe peut synchroniser le même corps vers .cursor/skills et .claude/skills en ajustant le frontmatter. Le standard résout la portabilité, pas les contraintes permanentes des Cursor Rules.

3. Tableau comparatif (How Compare)

3.1 Chemins et responsabilité

4. Matrice de décision par scénario

5. Stacks recommandés

Stack A — Cursor seul (projet perso)

• Rules : core.mdc avec trois lignes rouges (diff minimal, pas de commit sans demande, lint après modifs)
• Skills : un code-review (format Agent Skills sous .cursor/skills/)
• Pas de dossier .claude pour limiter le bruit

Stack B — Claude Code seul (terminal d’abord)

• Claude Skills : commit, security-review avec disable-model-invocation: true
• CLAUDE.md à la racine = contraintes permanentes (analogue Rules, pas Agent Skill)

Stack C — équipe double stack (recommandé)

• Répertoire source skills/ ou submodule ; CI vers .cursor/skills et .claude/skills
• Cursor Rules pour devs Cursor ; utilisateurs Claude lisent CLAUDE.md
• Nouveaux Skills d’abord selon Agent Skills, puis ajustement par outil

Stack D — agent avec exécution distante

• Skill décrit SSH vers Mac cloud et xcodebuild
• Rules interdisent prod sans confirmation
• Image macOS fixe — voir « environnement d’exécution » dans comparatif outils de code IA

6. Idées reçues

• « Agent Skills est exclusif à Claude » → format ouvert ; Claude Skills est une implémentation Anthropic.
• « 20 étapes de release dans Cursor Rules » → Skill ; Rules longues gaspillent le contexte.
• « Copier SKILL.md dans rules/ suffit » → extension et loader différents ; .mdc ne matche pas la description Skill.
• « Il faut choisir un seul » → typique : Rules + Skills + format Agent Skills.
• « Les Skills remplacent les Rules » → Skills à la demande ; « jamais force push » exige Rules permanentes.
• « Mise à jour du standard = compatibilité auto Claude » → suivre agentskills.io et changelogs hôtes.

7. Sept étapes de déploiement — exemples

1. Inventaire : contraintes à chaque chat → Rules ; flux occasionnels → Skills.
2. Écrire les Rules : < 80 lignes, globs pour le périmètre.
3. SKILL.md selon Agent Skills : name + description commençant par un verbe.
4. Dossier hôte : Cursor .cursor/skills/<name>/SKILL.md ; Claude .claude/skills/.
5. Skills à risque : disable-model-invocation: true, appel explicite uniquement.
6. Git : versionner avec le code dans le même PR.
7. Nœud macOS : dans le runbook, cible SSH et checks si Xcode/shell.

# .cursor/rules/core.mdc
---
description: Core repo constraints (always on)
globs: "**/*"
---
- Minimize diff; no drive-by refactors.
- Never commit unless the user explicitly asks.
- Do not modify backend/ unless the task requires it.

# .cursor/skills/code-review/SKILL.md  (Claude: .claude/skills/code-review/SKILL.md)
---
name: code-review
description: Review staged git diff for bugs and test gaps. Use when user asks for review or before PR.
---
1. Run `git diff --staged` (or branch vs main).
2. Report Critical / Warning / Suggestion.
3. Do not auto-fix unless asked.

---
name: xcode-release
description: Archive and export IPA on macOS runner. Manual invocation only.
disable-model-invocation: true
---
Prerequisites: macOS host, valid signing cert, Xcode selected.
Steps: clean → archive → export → verify IPA checksum.

8. Conclusion

Cursor Rules tracent ce qu’on ne doit jamais franchir dans Cursor ; Claude Skills standardisent les tâches dans Claude Code ; Agent Skills définissent la forme des SOP et leur transport entre hôtes. Ce n’est pas l’un ou l’autre, mais contraintes + capacité produit + standard de format. Classer par couche avant de copier une config tierce évite « fichier posé mais rien ne se déclenche ».

Pour aller plus loin : Cursor Rules · Claude Code Skills · Agent Skills · Workflow / Rules / Skills