Standard ouvert SKILL.md · chargement progressif · Cursor / Claude Code · recette Mac distant VNC
Qui rencontre ce probleme ? Vous codez deja avec un agent dans Cursor, Claude Code ou Gemini CLI — et vous recollez a chaque session comment deployer, ouvrir une PR ou lancer un audit. Le contexte se remplit, la facture de tokens pas moins. Conclusion : encapsulez les flux en Agent Skill (dossier avec en-tete YAML dans SKILL.md) ; l agent charge a la demande, reutilisable entre conversations. Si scripts/ contient des etapes macOS ou Xcode, validez la sortie sur un Mac distant VNC loue. Plan : Skill vs Rule → structure fichier → trois niveaux de chargement → creation & migration → bonnes pratiques → ecosysteme 2026 → cas pratiques → FAQ.
L evolution des agents IA est claire : chatbot → assistant de taches → agent doté de competences metier. Les prompts traditionnels echouent sur trois points : decrire a nouveau des flux complexes a chaque conversation ; des regles hors sujet qui saturent la fenetre de contexte ; un savoir d equipe impossible a versionner entre projets.
Les Agent Skills encapsulent le « comment faire X » en modules reutilisables : chargement a la demande, economies de tokens, partage inter-equipes. Depuis qu Anthropic a pousse le standard ouvert agentskills.io fin 2025, Cursor, Claude Code, OpenAI Codex et Gemini CLI partagent la meme arborescence SKILL.md.
Definition courte : un Skill est un manuel d exploitation pour l agent IA — pour qu il fasse la bonne chose au bon moment, sans repartir de zero a chaque fois.
Travail repetitif : deploy, tests, description de PR en prompt consomment souvent 2k–8k tokens par passage.
Pollution du contexte : 500 lignes de conventions dans les Rules — chaque edition de fichier emporte tout le paquet.
Non versionnable : accords oraux sans revue PR ; onboarding par copier-coller de chats.
Fragmentation plateforme : le meme flux deploy dans Cursor et Claude Code en double — le standard Skill permet le partage Git.
| Dimension | Rule (regle) | Skill (competence) |
|---|---|---|
| Moment de chargement | Toujours charge | A la demande / si pertinent |
| Usage | Conventions durables (nommage, style) | Workflows complexes (deploy, audit) |
| Contexte | Overhead fixe | Dynamique et efficace |
| Declenchement | Injection automatique | Routage agent + /skill-name |
| Analogie | Fiche d accueil | Runbook specialise |
Ce que les Skills ajoutent : commandes / personnalisees (ex. /deploy), workflows multi-etapes, connaissance metier, scripts Bash/Python/Node embarques, lien avec Hooks et MCP. Notre article sur le marche de competences OpenClaw traite des plugins produit ; ici le format de fichier Skill inter-editeurs — idee proche, ecosystemes differents.
Arborescence standard (nom du dossier = nom du skill) :
.cursor/skills/
└── deploy-app/
├── SKILL.md # obligatoire
├── scripts/ # optionnel : scripts executables
│ ├── deploy.sh
│ └── validate.py
├── references/ # optionnel : docs de reference
└── assets/ # optionnel : modeles et ressourcesChemins compatibles : .agents/skills/ (Claude Code, Codex, Gemini CLI), ~/.cursor/skills/ (global utilisateur), ~/.agents/skills/ (global multi-outils).
--- name: deploy-app description: >- Quand l utilisateur veut deployer une app en staging ou production. Mots-cles : deploy, release, mise en ligne, changement d environnement. paths: - "apps/web/**" disable-model-invocation: false --- # Deployer l application ## Etapes 1. Executer `scripts/validate.py` pour verifier les variables d environnement 2. Lancer `scripts/deploy.sh <environment>` 3. Verifier que le health check renvoie HTTP 200
| Champ | Obligatoire | Role |
|---|---|---|
| name | Oui | Minuscules + tirets, identique au dossier |
| description | Oui | Cle de routage : conditions de declenchement, pas un resume |
| paths | Non | Glob limitant les fichiers concernes |
| disable-model-invocation | Non | true = declenchement manuel /skill-name uniquement |
Les Agent Skills utilisent le progressive disclosure — documente en trois phases sur agentskills.io et dans la doc officielle :
Decouverte (demarrage session) : seuls name + description de chaque Skill — evaluation de pertinence.
Activation (match) : lecture du corps complet de SKILL.md et execution des etapes.
A la demande (execution) : references/ si necessaire ; pour scripts/, seule la sortie du script entre dans le contexte, pas le code source.
Declencheurs : automatique (agent decide, defaut) ; manuel /skill-name ; avec contexte @skill-name. Pour operations sensibles, disable-model-invocation: true et validation humaine avant chargement.
Chiffre communautaire : debut 2026, plus de 31 000 Skills disponibles. Tous en Rules feraient gonfler le contexte d un facteur 10+ — le chargement progressif signifie : l agent « sait qu il existe beaucoup de manuels, n ouvre que celui du moment ».
Voie rapide : dans Cursor Agent, saisir /create-skill, decrire le Skill — l agent genere dossier et SKILL.md.
Manuel : creer SKILL.md sous .cursor/skills/votre-skill/ avec frontmatter et etapes.
Scripts optionnels : commandes repetitives dans scripts/, references par chemin relatif dans le texte.
Verifier la detection : Cursor Settings → Rules, ou redemarrer la session agent — Skill visible ?
Migration : des Cursor 2.4+, /migrate-to-skills convertit dynamic rules et slash commands en dossiers Skill.
Sous Windows, vous ecrivez le Skill dans Cursor ; si scripts/ contient bash, xcodebuild ou notarytool, l execution locale est impossible. Flux recommande : sync Git sur Mac distant loue → VNC avec Cursor ou terminal → declencher le Skill → verifier codes de sortie et logs. Keychain, notarisation et etapes TCC exigent VNC — voir notre checklist permissions TCC.
① description = routage, pas resume. Mauvais : « Ce skill contient des instructions de deploy. » Bon : « Quand l utilisateur mentionne deploy, mise en ligne ou staging/production, appliquer. »
② Progressive disclosure : garder SKILL.md sous 500 lignes ; details dans references/ ; logique d execution dans scripts/.
③ Responsabilite unique : un Skill, un domaine — « deploy + audit securite + ecrire tests » = trois Skills.
④ Expliquer le pourquoi : « Avant deploy, validate.py evite un demarrage sans variables d env » — pas seulement « lancer validate.py ».
⑤ Gather → Act → Verify : collecter, agir, verifier — l agent reagit mieux aux ecarts.
⑥ Terminologie coherente, chemins POSIX, gestion d erreurs explicite : en cas d echec script, retry, rollback ou arret — a preciser dans le texte.
| Categorie | Exemples | Usage |
|---|---|---|
| Productivite dev | Prompt Lookup, Skill Installer, Ralph Coding Loop | Meilleurs prompts, installation Skills, iteration TDD autonome |
| Frontend / Web | React Best Practices, Web Design Audit, Next.js Cache Optimizer | Audits perf et accessibilite (dont Vercel) |
| Workflow | PR Skill, TDD Skill, Skill Writer | Commit → push → PR, test-driven, meta-skills |
| Creatif | Remotion Video Editor | Montage video decrit en React |
Ecosysteme 2026 : agentskills.io comme base multi-plateforme ; Cursor Marketplace pour bundles Rules+Skills+MCP ; en monorepo, chemins imbriques .cursor/skills/shipping/deploy-staging/SKILL.md pour isoler le perimetre.
Rapport avec MCP : MCP connecte APIs externes (BDD, navigateur, GitHub). Les Skills definissent quand et dans quel ordre utiliser les outils. Un PR Skill peut faire git status puis appeler GitHub MCP — complementaires, pas substituts.
Scenario : chaque release = commit → push → PR → description. Skill : committer, pousser branche, gh pr create, remplir le modele — un /pr pour tout.
Scenario : modifier jusqu aux tests verts. Skill : lancer tests → si echec, agent corrige → relancer. Les Hooks peuvent reveiller l agent sur echec CI.
Scenario : developpeur Windows maintient un Skill avec xcodebuild archive et notarytool submit. En local, edition Markdown seulement ; recette reelle sur Mac distant VNCMac : VNC → declencher Skill → agent execute scripts → clic Keychain « Toujours autoriser » en GUI. Comme notre checklist notarytool stapler — SSH seul insuffisant.
| Point de recette | Windows local | Mac distant + VNC |
|---|---|---|
| Editer SKILL.md | Oui | Oui |
| Scripts bash deploy | WSL partiel | Environnement macOS complet |
| xcodebuild / notarisation | Non | Obligatoire |
| Keychain / dialogues TCC | Non | Clic GUI VNC |
Un Skill est un guide structure, pas une contrainte absolue. Le modele decide encore ; description et etapes claires augmentent la coherence. Lisez scripts/ avant d installer un Skill communautaire.
Tester avec de vraies taches ; verifier les mots declencheurs dans description. Si pas de chargement auto : /skill-name manuel. Ajouter des synonymes en tete de description.
Workflows generiques (commit, tests) dans ~/.cursor/skills/ ; chemins et APIs internes du repo dans .cursor/skills/ projet, commite en Git.
Idees proches (modules reutilisables), mais OpenClaw passe par ClawHub et plugins Gateway ; Cursor Agent Skills suivent SKILL.md et agentskills.io. Coexistence possible : OpenClaw gateway 7×24, Cursor Skills pour le coding.
Les Agent Skills transforment les flux « connus des anciens » en runbooks SKILL.md versionnables, revus et partageables. description = declencheur, corps = Gather-Act-Verify, scripts dans scripts/ — l agent passe de « reapprendre a chaque fois » a « consulter le manuel ».
Limite reelle : Skills avec build macOS, notarisation et Keychain s ecrivent sous Windows mais ne se valident pas localement ; SSH seul sur Mac distant ne clique pas les dialogues systeme. Un Mac mini dedie convient aux equipes agent 7×24 ; pour une recette mensuelle iOS/macOS, separez ecriture sur poste principal et execution sur Mac distant VNC — souvent plus economique qu un achat materiel occasionnel.
La valeur d un Skill est la reutilisation — la reutilisation exige un environnement qui tourne. Consultez les forfaits Mac distant pour un noeud VNC de validation macOS.