2026 AGENT
SKILLS_
GUIDE_
MAC.
Sur Mac avec Cursor, vous répétez encore à chaque session le même scénario — déployer en staging, lancer les tests, ouvrir une PR ? Les prompts jetables et les Rules toujours actives consomment le contexte sans voyager d’un dépôt à l’autre. Les Agent Skills encapsulent le savoir-faire opérationnel dans un dossier SKILL.md, chargé à la demande quand la tâche correspond. Le standard ouvert agentskills.io (fin 2025) est adopté par Cursor, Claude Code, Gemini CLI et 16+ outils. Ce guide professionnel et créatif 2026 couvre Skill vs Rule, la disclosure progressive en trois niveaux, l’arborescence, /create-skill, MCP, et les workflows Mac distants 7×24. En résumé : déplacez les procédures des Rules vers les Skills ; rédigez description comme condition de déclenchement ; projet dans .cursor/skills/, transversal dans ~/.cursor/skills/.
1. Pourquoi les Skills changent la donne en 2026
Quatre frictions reviennent chez les équipes créatives sur Mac. Les prompts ne sont pas réutilisables : 800 tokens de runbook deploy à chaque chat. Les Rules occupent le contexte en permanence : le style peut rester ; le runbook release de 12 Ko non. La fragmentation d’outils pousse vers .agents/skills/ pour partager avec Claude Code. Enfin, MCP ≠ Skill : MCP expose les API ; le Skill ordonne les appels et les vérifications.
Début 2026 : plus de 31 000 Skills publics recensés ; le marketplace Cursor regroupe Rules, Skills et MCP. La disclosure progressive inverse la courbe de coût : métadonnées de découverte légères (~100 tokens/Skill), corps complet seulement si pertinent (<5000 tokens recommandés pour SKILL.md).
Sur un Mac qui héberge Xcode, Final Cut et ComfyUI, chaque kilo-octet de Rule always-on est de la mémoire unifiée que vous ne consacrez plus au diff ni au log de test. Les Skills ne libèrent pas magiquement la RAM, mais ils retirent la prose opérationnelle de la couche la plus chaude du contexte pendant une simple retouche CSS.
2. Skill vs Rule : tableau de responsabilités
| Dimension | Rule | Skill |
|---|---|---|
| Chargement | Toute la session | Quand la tâche correspond |
| Cas d’usage | Style, nommage, sécurité | Deploy, PR, audit, runbooks |
| Coût contexte | Fixe à chaque tour | Disclosure progressive, moyenne plus basse |
| Métaphore | Livret d’accueil | Manuel d’opérateur spécialisé |
| Emplacement Mac | .cursor/rules/ | .cursor/skills/ ou ~/.cursor/skills/ |
Cursor 2.4+ : /migrate-to-skills pour les Rules dynamiques surchargées ; viser <2 Ko de Rules à haute densité signal.
3. Arborescence et contrat SKILL.md
Un Skill est un dossier. Obligatoire : SKILL.md. Optionnel : scripts/, references/, assets/ :
Exemple de frontmatter — la description indique quand activer :
4. Disclosure progressive en trois niveaux
Niveau 1 — Découverte : name + description au démarrage. Niveau 2 — Activation : corps complet de SKILL.md (<500 lignes). Niveau 3 — Exécution : references/, scripts/, sorties dans le transcript. Modes : automatique, manuel (/nom-skill), attaché (@nom-skill). Pour la production, préférez le déclenchement manuel — la créativité de formulation ne doit pas court-circuiter la validation humaine.
5. Chemins de découverte sur macOS
| Chemin | Portée | Usage typique |
|---|---|---|
.cursor/skills/ | Dépôt | Deploy, schéma métier |
~/.cursor/skills/ | Utilisateur global | Commit, tests, PR |
.agents/skills/ | Projet multi-outils | Runbooks partagés |
~/.agents/skills/ | Global multi-outils | Standards d’équipe |
Après ajout, vérifiez Settings → Rules : le Skill doit apparaître avant le test d’intégration.
6. Cinq étapes pour créer votre premier Skill
Étape 1 — Assistant intégré
Dans l’Agent : /create-skill — décrivez le flux en langage naturel (ex. commit → push → PR avec gh).
Étape 2 — Aligner name et dossier
Minuscules, chiffres, tirets ; le nom du dossier = champ name.
Étape 3 — description = déclencheurs
❌ « Ce skill contient des instructions de deploy » → ✅ « Quand deploy, release, staging, production, pipeline ».
Étape 4 — logique dans scripts/
Bash/Python avec codes de sortie explicites ; le Skill documente quand et comment revenir en arrière.
Étape 5 — Valider sur une vraie tâche
Test par paraphrase (pas le texte exact de la description) ; /migrate-to-skills si legacy Rules volumineuses.
7. Écosystème 2026 et matrice workflow Mac
| Capacité | Encapsuler en | Note Mac |
|---|---|---|
| Style / sécurité | Rule | court, always-on |
| Deploy / PR / audit | Skill | scripts/ + nœud distant SSH |
| API GitHub / SaaS | MCP | Skill enchaîne les noms d’outils |
| OpenClaw 7×24 | Skill + passerelle Mac distante | voir série OpenClaw |
| Benchmarks MLX / Ollama | references/ + scripts/ | sur machine avec marge thermique |
Tendances 2026 : pack Vercel React Best Practices (40+ règles perf), PR Skills avec gh, Skills TDD. OpenClaw : rafraîchir le snapshot après /new — runbook skillsSnapshot.
8. Bonnes pratiques (mémo opérateur)
• Une responsabilité par Skill — découper deploy / verify / rollback.
• SKILL.md <500 lignes ; tomes API dans references/.
• Expliquer le pourquoi — l’agent improvise mieux.
• Vocabulaire stable — un verbe pour « déployer ».
• Collecter → Agir → Vérifier avec preuve observable (URL PR, tests verts).
9. Étude de cas : /mac-quote sur une plateforme Mac GPU
« Trois Skills pour le support : /mac-quote (modèle + durée → devis), /contract-draft (contrat type), /device-check (checklist retour). La tarification vit dans scripts/quote.py ; SKILL.md ~120 lignes. Après migration : délai moyen 18 → 6 minutes, Rules 12 Ko → 2 Ko — le MacBook respire enfin pendant la complétion. »
Miroir dev : Skill remote-mac-acceptance — SSH, ports, smoke MLX sur le Mac du datacenter ; Cursor reste la console légère. Le Skill dit comment ; le Mac distant dit où.
10. FAQ et chiffres citables
Q : Skill vs MCP ? MCP = fil ; Skill = playbook.
Q : Les Skills forcent-ils l’agent ? Non — guidance, pas sandbox.
Q : Version Cursor ? 2.4+ stable.
À citer : ① 16+ outils (2026-T1). ② 31 000+ Skills communauté. ③ Cas support 18→6 min. ④ Corps SKILL.md <5000 tokens. ⑤ Découverte ~100 tokens/Skill.
Checklist d’acceptation : description = déclencheurs □ | name = dossier □ | scripts exécutables + échecs □ | chemin projet/global □ | MCP séparé □ | test paraphrase □ | smoke SSH distant □
11. De l’orchestration Windows/Linux au nœud de calcul Mac
Vous pouvez rédiger des Skills partout ; le Mac reste le chemin le plus fluide pour Xcode, Final Cut, ComfyUI, inférence Metal et passerelles launchd 7×24. Architecture 2026 : Skills = procédure ; nœud Mac = capacité. Gardez SKILL.md sur la machine où vous dialoguez avec l’agent ; parquez les scripts/ longs sur un Mac Apple Silicon alimenté en continu.
Pour une capacité Apple Silicon fiable (scripts, passerelles, régressions), un nœud Mac distant MACGPU exécute OpenClaw et les files nocturnes ; Cursor reste votre pupitre créatif.