Guide Agent Skills 2026 : de SKILL.md aux workflows Cursor réutilisables (Mac cloud)

Selon la documentation Cursor, un Skill est un pack de capacités portable, traçable Git (scripts, modèles, références). L'agent le choisit si pertinent ou vous invoquez /skill-name. Anthropic a open-sourcé le format fin 2025 ; la spec est sur agentskills/agentskills.

• Workflows répétitifs : « lint → test → commit → gh pr create » doit être réexpliqué à chaque nouveau chat.
• Rules toujours actives : style et « pas de commentaires » vont dans .cursor/rules ; un runbook deploy de 200 lignes là gaspille des tokens sur des tâches sans lien.
• Pas de réutilisation d'équipe : les Skills en repo passent en revue PR ; les SOP orales non.
• Pas MCP : MCP branche des API externes ; les Skills indiquent à l'agent dans quel ordre utiliser les outils existants.

Les Rules sont des docs d'onboarding (toujours présentes). Les Skills sont des runbooks (ouverts quand la tâche correspond).

Cursor 2.4+ propose /migrate-to-skills pour migrer certaines rules dynamiques et anciennes commandes slash vers Skills. Gardez moins de ~10 Rules strictes ; déplacez le contenu procédural vers Skills.

Chaque Skill est un dossier avec au minimum SKILL.md (frontmatter YAML + Markdown). Optionnel : scripts/, references/, assets/. Chemins courants :

• Projet Cursor : .cursor/skills/your-skill/SKILL.md
• Projet multi-outils : .agents/skills/your-skill/SKILL.md
• Global utilisateur : ~/.cursor/skills/ ou ~/.agents/skills/

La spec ouverte utilise la progressive disclosure : (1) au démarrage, tous les name + description (~100 tokens chacun) ; (2) à la correspondance, SKILL.md complet (moins de ~5000 tokens recommandé) ; (3) pendant l'exécution, references/ ou scripts/ — la sortie script entre dans le chat, pas forcément le source.

---
name: deploy-staging
description: >-
  Use when the user deploys to staging or says "pre-prod release".
  Keywords: deploy, staging, pre-prod.
paths:
  - "apps/web/**"
---

# Deploy to staging

## Steps
1. Run `scripts/validate.py`
2. Run `scripts/deploy.sh staging`
3. curl health URL; stop if not 200

description est une clé de routage, pas un résumé. Indiquez quand déclencher et ce que disent les utilisateurs. name doit correspondre au dossier ; minuscules, chiffres, tirets ; max 64 caractères selon la spec.

1. Choisir un job : ex. « ouvrir PR » ou « audit sécurité » — pas « code + deploy + blog » dans un seul Skill.
2. Esquisser en chat : lancer /create-skill et décrire déclencheurs et étapes.
3. Commiter le layout : créer .cursor/skills/pr-release/ avec name: pr-release aligné sur le dossier.
4. Rendre les étapes vérifiables : Gather → Act → Verify : lire git status, exécuter gh pr create, confirmer avec gh pr view ; documenter les échecs (ex. gh auth login).
5. Scripts optionnels : bash répétable dans scripts/ ; expliquer le pourquoi en prose (ex. vérif env avant deploy).
6. Tester les déclencheurs : phrases utilisateur réelles ; vérifier la découverte dans Cursor Settings → Rules ; migrer les anciennes Rules avec /migrate-to-skills et supprimer les doublons.

Aussi : terminologie cohérente, slashes avant dans les chemins, SKILL.md cœur sous ~500 lignes ; détails dans references/.

• Frontmatter requis : name (≤64 car.), description (≤1024 car., non vide) — Agent Skills Specification.
• Guidance chargement progressif : métadonnées ~100 tokens ; instructions complètes <5000 tokens ; ressources à la demande — même spec.
• Extras Cursor : globs paths, disable-model-invocation: true pour manuel uniquement — Cursor Skills docs.
• Répertoires cross-plateforme : Claude Code ~/.claude/skills, Codex ~/.codex/skills, projet Cursor .cursor/skills ; un repo peut servir plusieurs outils.
• Thèmes 2026 : automatisation PR, boucles TDD, Skills audit React/Next — préférer sources Marketplace signées avant scripts non fiables.

FAQ : les Skills guident ; ils ne retirent pas l'agency du modèle. Skills globaux dans ~/.cursor/skills/ ; Skills projet en repo. Stable dès Cursor 2.4+.

Les Skills exigent toujours un hôte macOS toujours disponible : les portables dorment ; les Mac perso laissent tomber les gateways Telegram/OpenClaw ; mélanger CI et Cursor sur un Apple ID risque des problèmes de certificats.

Topologie suggérée : portable pour edits quotidiens et /create-skill ; Mac loué clone le repo avec launchd pour gateways (voir guide OpenClaw launchd) ; Skills PR sur le serveur pour que le sommeil ne coupe pas gh à mi-chemin. CI séparée selon le guide CI hybride.

Points faibles des hôtes sursouscrits et « Mac empruntés » : (1) contention IO fait expirer les scripts de validation Skill ; (2) coupures SSH tuent les longues boucles agent ; (3) dérive Xcode non bare metal casse les étapes xcodebuild reproductibles.

Pour l'automatisation Agent en production, les Mac bare metal multi-région JEXCLOUD avec bail mensuel et .cursor/skills projet dans le même repo conviennent généralement mieux — Apple Silicon dédié, 24h/24, conditions flexibles. Voir tarifs et commande.