SKILL.md versionnables que l'agent charge à la demande. Ce guide s'adresse aux développeurs et aux utilisateurs avancés. Il couvre la répartition Rule / Skill / MCP ; la structure conforme à agentskills.io ; le chargement progressif en trois niveaux ; un runbook en six étapes avec /create-skill ; les données d'écosystème 2026 ; et le choix d'un hôte Mac 7×24 pour des workflows créatifs Apple stables.
Pourquoi des Agent Skills en 2026 ? Trois limites du prompt classique
La trajectoire des agents IA est nette : du chatbot à l'assistant de tâches, puis à l'agent doté de workflows métier. Anthropic a publié Agent Skills fin 2025 comme norme ouverte. Cursor 2.4+, Claude Code, Codex et Gemini CLI partagent le même modèle SKILL.md — un Skill écrit dans Cursor se réutilise souvent dans Copilot ou Codex avec un simple ajustement de chemin.
Travail répétitif : Les flux multi-étapes doivent être réexpliqués à chaque conversation — commit, push, description de PR — avec risque d'oubli et de dérive entre collègues.
Pollution du contexte : Un manuel de déploiement entier dans les Rules occupe en permanence des tokens et chasse le code utile.
Peu de réutilisabilité : L'historique de chat ne se versionne pas proprement dans Git ; l'équipe ne partage pas ses runbooks agent comme du code.
La réponse Skill : Isoler chaque processus dans un dossier ; description route la tâche, le corps ne charge que si pertinent ; les scripts dans scripts/ s'exécutent — leur source n'entre pas dans le contexte, seule la sortie.
Définition courte : Un Skill est le manuel opératoire de l'agent — bon moment, bonnes étapes. Proche du skill compounding chez Hermes, mais Cursor insiste sur standards rédigés par l'humain + revue Git.
Les annuaires communautaires citent début 2026 souvent plus de 30 000 Skills installables (Marketplace et agrégateurs). La norme vient d'Anthropic, code Apache 2.0, documentation CC-BY-4.0 — ce qui limite l'enfermement propriétaire.
Agent Skill, Rule et MCP : qui fait quoi ?
| Dimension | Rule | Skill | MCP |
|---|---|---|---|
| Moment de chargement | Par défaut chaque session | Quand la tâche correspond | Lors de l'appel d'outil |
| Cas typiques | Nommage, interdiction de commentaires, ton | Déploiement, PR, audit sécurité, runbooks | API GitHub, base de données, navigateur |
| Coût contexte | Réservé en fixe | Plein texte si activé | Selon schéma d'outil |
| Analogie | Checklist d'intégration | Manuel spécialisé | Prise + annuaire API |
| MESHLAUNCH | .cursor/rules/ | .cursor/skills/ ou .agents/skills/ | CI, outils Issue en option |
Les Rules répondent à « Que doit toujours respecter l'agent ? » Les Skills répondent à « Quelles étapes pour ce type de tâche ? » MCP répond à « Quelles capacités externes sont branchées ? »
Cursor recommande des Rules courtes et de qualité, les flux rares dans des Skills. Avec /migrate-to-skills (2.4+), migrez anciennes dynamic rules et slash commands — et évitez l'embonpoint des Rules.
Structure SKILL.md et chargement progressif en trois niveaux
Arborescence standard au niveau projet :
.cursor/skills/deploy-app/
├── SKILL.md
├── scripts/
│ ├── validate.py
│ └── deploy.sh
├── references/
│ └── REFERENCE.md
└── assets/
└── config-template.json
En monorepo, des chemins imbriqués comme apps/web/.cursor/skills/ font surface uniquement lors de l'édition dans ce sous-arbre — proche du Glob paths du frontmatter.
--- name: deploy-app description: >- Utiliser quand l'utilisateur veut déployer, « mettre en prod », basculer staging/production ou parler de release. paths: apps/web/** disable-model-invocation: false --- # Déployer l'application ## Étapes 1. Lancer `scripts/validate.py` pour les variables d'environnement 2. Exécuter `scripts/deploy.sh <environment>` 3. Vérifier le health check HTTP 200
Trois niveaux (agentskills.io et doc Cursor) : Niveau 1 découverte — au démarrage seulement name + description ; Niveau 2 activation — SKILL.md complet si la tâche correspond ; Niveau 3 à la demande — lire references/, exécuter scripts/. Déclencheurs : routage auto, /skill-name ou @skill-name ; avec disable-model-invocation: true, slash manuel uniquement.
| Chemin de découverte | Portée |
|---|---|
.cursor/skills/ | Projet Cursor |
.agents/skills/ | Claude Code / Codex / Gemini CLI |
~/.cursor/skills/ | Global Cursor |
~/.agents/skills/ | Global multi-outils |
Bonnes pratiques : description = conditions de déclenchement, pas un résumé ; une responsabilité par Skill ; SKILL.md sous ~500 lignes, détails dans references/ ; étapes motivées ; terminologie cohérente.
Créer son premier Agent Skill : runbook en six étapes
Voie rapide : Dans Cursor Agent, saisir /create-skill, décrire le workflow, l'assistant enregistre sous .cursor/skills/.
Manuel : Créer .cursor/skills/your-skill-name/ et SKILL.md ; name = nom du dossier (minuscules, chiffres, tirets).
Rédiger description : Lister verbes et scénarios (« ouvrir PR », « merge request », « gh pr create ») — cœur du routage automatique.
Externaliser scripts : Commandes répétées dans scripts/ ; le corps indique quand lancer et comment rollback ; chemins en slash scripts/deploy.sh.
Migration : /migrate-to-skills pour anciennes dynamic rules et slash commands ; vérifier Settings → Rules.
Validation : Tâche réelle — si l'agent ne charge pas, affiner description plutôt qu'allonger le corps ; Gather → Act → Verify : git status, exécution, test ou HTTP.
Types de Skills fréquents en 2026 (sélection) : efficacité dev — Prompt Lookup, Skill Installer, boucles de test autonomes ; frontend — audits perf React/Next et accessibilité ; workflow — PR Skill, TDD Skill, Skill Writer. Contrairement à ClawHub chez OpenClaw, les Skills Cursor restent proches des sessions de code IDE ; contrairement à Hermes auto-skills, la revue humaine + PR Git prime.
Écosystème 2026 et hôte Mac 7×24 : faits exploitables
Norme ouverte : agentskills.io définit frontmatter, corps Markdown, chemins de découverte ; Anthropic explique l'emballage du savoir procédural en dossiers portables.
Multi-plateforme : Un même Skill charge dans Cursor, VS Code Copilot, Codex CLI ; Microsoft Agent Framework expose SkillsProvider et run_skill_script.
Hôte & effet composé : Skills liés à launchd, signature Xcode, automatisation navigateur macOS ou Gateway Telegram (voir architecture mémoire Hermes) souffrent du sommeil du portable — M4 au repos ~4–6 W, Gateway typique 15–25 W, fonctionnement continu pertinent.
Cas MESHLAUNCH : le support ou les ops peuvent modéliser « modèle + durée → devis », brouillons contractuels ou checklists de retour en Skills projet — sur le Mac Mini loué aux côtés de Cursor Agent, sans les contraintes de veille du laptop personnel.
Un VPS Linux couvre les Skills génériques mais manque les chemins macOS ; un Raspberry Pi échoue sur les Skills navigateur par I/O et RAM. Pour valider Skill + Gateway + routage modèle local 7×24, la location Mac Mini M4 bare metal MESHLAUNCH offre Apple Silicon dédié, SSH et la même arborescence qu'en local ; avant résiliation, export de .cursor/skills et état agent. Consultez les tarifs et le centre d'aide. Tests destructifs en environnement isolé : page de commande.
MCP connecte API et outils ; le Skill est le runbook — quand et dans quel ordre. Complémentaires ; le corps peut indiquer « d'abord MCP Issue, puis gh pr create ».
Le Skill structure, le modèle décide encore. Plus la description reflète le langage utilisateur, plus le déclenchement est stable ; documenter le rollback en production. Tests isolés via la page de commande.
Workflows généraux dans ~/.cursor/skills/ ; flux spécifiques au dépôt dans .cursor/skills/ et commit Git. Cursor 2.4+ stable. Questions de déploiement : centre d'aide.