Table des matières

01 · Ce qu’est (et n’est pas) un Agent Skill

Un Agent Skill est un dossier de connaissances procédurales que l’agent peut découvrir, activer et suivre. Minimum : SKILL.md (frontmatter YAML + Markdown). En option : scripts/, references/, assets/. Quand vous demandez « déploie staging comme mardi », un bon skill de déploiement fournit la checklist, les flags gh/kubectl standardisés et les scripts de validation.

Les Skills ne remplacent pas le raisonnement général du modèle : ce sont des playbooks spécialisés chargés seulement quand c’est pertinent. Chaque token en contexte concurrence vos fichiers ouverts et l’historique. En 2026, Cursor 2.4+ expose Skills aux côtés des Rules, serveurs MCP et outils intégrés — les confondre mène souvent à des Rules géantes toujours actives et un agent lent.

Le format s’aligne sur la spécification inter-vendeurs agentskills.io, adoptée par Cursor pour que les skills écrits aujourd’hui voyagent entre éditeurs et frameworks d’agents.

02 · Agent Skills vs Cursor Rules

Les Rules (.cursor/rules/) sont des garde-fous persistants : style, « ne jamais committer de secrets », préférences de langue. Les Skills sont orientés tâche : ils s’activent quand la description correspond à la demande.

Dimension	Cursor Rules	Agent Skills
Objectif principal	Politique et style permanents	Procédures à la demande
Taille typique	Paragraphes courts, plusieurs fichiers	SKILL.md + références profondes
Modèle de chargement	Injecté si le scope matche	Metadata toujours ; corps au trigger
Scripts exécutables	Rare ; pas le focus	First-class dans `scripts/`
Portabilité	Centré Cursor	Interop agentskills.io

Heuristique : sans ce texte, l’agent serait-il unsafe ou incohérent sur les edits routiniers ? → Rule. Serait-il seulement moins efficace sur des workflows rares ? → Skill. Évitez de dupliquer le même paragraphe dans cinq Rules : une ligne Rule qui renvoie au skill « deploy-staging » suffit.

03 · Le standard agentskills.io

Début 2026, le format Agent Skills est une spécification ouverte sur agentskills.io : tout runtime qui liste des dossiers, parse du YAML et lit du Markdown peut implémenter la découverte progressive.

Champs obligatoires : name, description. Dossiers recommandés : scripts/, references/, assets/. En CI, validez longueur du frontmatter, cohérence nom/dossier, scripts exécutables — les skills deviennent des artefacts versionnés, pas du folklore de chat.

04 · Format SKILL.md et arborescence

Chaque skill centre sur SKILL.md. La commande /create-skill de Cursor structure l’interview (objectif, triggers, perso vs projet).

                        ---

name: deploy-staging

description: Déploie l'app en staging via gh et kubectl. Utiliser si l'utilisateur mentionne staging deploy, hotfix staging ou validation RC.

compatibility: kubectl context staging, gh authentifié, shell macOS ou Linux.

---

# Déploiement staging

1. Exécuter scripts/preflight.sh --env staging

name — max 64 car., minuscules, chiffres, tirets
description — max 1024 car., QUOI + QUAND + mots-clés déclencheurs
Corps — < ~500 lignes ; profondeur dans references/

Emplacements : personnel ~/.cursor/skills/ ; projet .cursor/skills/. Ne pas écrire les skills équipe dans ~/.cursor/skills-cursor/ (réservé Cursor).

05 · Chargement progressif en trois niveaux

Niveau 1 — Metadata (~100 tokens/skill) : name + description au catalogue.
Niveau 2 — Instructions (<5 000 tokens recommandés) : corps complet de SKILL.md.
Niveau 3 — Ressources : scripts, références, assets à la demande.

Mettez la logique de trigger dans la description, l’essentiel dans SKILL.md, l’encyclopédique à un saut dans references/. Préférez des scripts packagés à cinquante lignes de Bash inline. Souvent disable-model-invocation: true pour n’activer qu’explicitement.

06 · Rédiger avec /create-skill

Décrire un workflow répété ≥3 fois le mois dernier.
Choisir stockage perso vs projet.
Coller les formulations exactes (legal, release notes).
Demander un script de validation si prod touchée.
Tester tout de suite ; affiner les keywords de description.

Pour la boucle Hermes → SKILL.md, voir notre bilan 30 jours Skills Hermes.

07 · Bonnes pratiques production

Écrire pour la découverte

Investissez dans description : noms produits, extensions, chaînes d’erreur, phrases Slack.

Degré de liberté

Haute liberté : culture de review. Moyenne : gabarits. Basse : scripts épinglés pour migrations sensibles.

Boucles de feedback & sécurité

Pattern : edit → python scripts/validate.py → corriger. Pas de clés API dans SKILL.md. Skills tiers : sécurité ClawHub et isolation.

08 · FAQ : Agent Skills vs MCP

Un Skill est-il un serveur MCP ?

Non. MCP connecte des systèmes live (tickets, DB, navigateur). Les Skills sont expertise packagée + scripts locaux.

MCP ou Skill ?

MCP pour données fraîches chaque tour. Skill pour procédures au rythme humain. Ils se composent. Voir intégration MCP et approbation.

Le champ allowed-tools ?

Pré-approuve des noms d’outils ; MCP reste le transport. Skills = programme ; MCP = équipement de labo.

09 · Sandbox location Mac en cinq étapes

Les skills avec scripts/deploy.sh, brew ou webhooks prod brûlent Keychain et Docker sur le MacBook quotidien. Le pattern 2026 : Mac mini M4 loué 1–3 jours, validation bout en bout, puis wipe.

Étape 1 — Louer un nœud macOS propre

Compte frais, SSH/VNC. Tarifs : guide tarifs Mac mini M4, tarifs bare-metal macOS. Côté RGPD, documentez la finalité « essai skill » et l’effacement à la restitution.

Étape 2 — Synchroniser uniquement les skills

Branche git privée ou rsync de .cursor/skills/ vers ~/skill-sandbox/, symlink vers les chemins Cursor. Exclure .env et dotfiles non liés.

Étape 3 — Installer les dépendances

compatibility : nvm, venv, brew bundle. chmod +x scripts/*, tester --help manuellement.

Étape 4 — Dry-run puis agent

Scripts en --dry-run ou endpoints staging. Journaliser codes de sortie. Puis Cursor sur le Mac loué : comparer aux commandes manuelles.

Étape 5 — Promouvoir ou abandonner

Merge si OK. Sinon effacement selon checklist retour zéro trace. FAQ opérationnelle : FAQ location Mac SSH/VNC.

Pourquoi louer plutôt qu’acheter pour la R&D Skills

Acheter un Mac mini pour des essais occasionnels immobilise du capital et pollue quand même l’environnement principal. La location journalière aligne la dépense sur les 24–72 h où les scripts sont dangereux. Plusieurs auteurs en parallèle = nœuds séparés, pas un Mac de bureau partagé avec des recettes brew conflictuelles.

10 · FAQ générale

Combien de skills activer ?

Viser 10–20 skills bien délimités par dépôt. Archiver après 90 jours sans trigger.

Partager entre Cursor et Claude Code ?

Layout agentskills.io de plus en plus portable ; vérifier outils et chemins.

L’agent ne choisit jamais mon skill ?

Réécrire la description, scinder les skills surchargés, tester nouvelle session.

Migrer des packs OpenClaw ?

Contenu procédural oui ; plugins gateway non — essai ClawHub en location journalière.

Les Agent Skills transforment les prompts récurrents en actifs durables. Rules = garde-fous ; MCP = données live ; Skills = procédures éprouvées. Rédigez pour agentskills.io, respectez trois niveaux, utilisez /create-skill, et louez un Mac isolé quand les scripts peuvent faire mal — c’est le workflow 2026 des équipes Cursor matures.