Poste de travail bi-écran avec IDE et code source — Cursor, Claude Code et Agent Skills GitHub

En mai 2026, mattpocock/skills reste en tête de GitHub Trending, avec plus de 100 000 étoiles. Matt Pocock (Total TypeScript) a ouvert ses Agent Skills privés — pas un prompt de plus, mais une discipline d'ingénierie composable qui oblige Claude Code, Cursor ou Codex à : aligner, coder, vérifier.

Si vous en avez assez des agents qui modifient cinquante fichiers d'un coup, laissent les tests rouges et déclarent « terminé », cet article suit problème → architecture → comparaison → workflow. Vous repartirez avec la commande d'installation, une chaîne de skills recommandée, les limites face à OpenClaw et la mémoire Cursor, plus une checklist pour équipes Mac. Pour distinguer mémoire de session et skills de processus, voir notre article sur Cursor et la collaboration sur plusieurs semaines.

1. Le vibe coding manque de processus, pas de modèle

En 2026, « vibe coding » sonne presque péjoratif : plus le modèle est fort, plus le diff est gros — et plus le coût d'une mauvaise direction grimpe. Matt résume dans le README quatre échecs récurrents, les mêmes que dans la littérature classique, avec un agent comme accélérateur :

  • Mauvaise cible (misalignment) : vous pensiez avoir été clair ; l'agent a compris autre chose — la surprise arrive au merge.
  • Verbosité : sans vocabulaire métier, vingt mots deviennent un paragraphe — tokens et revues en souffrent.
  • Pas de feedback : pas de test rouge, pas de typage, pas de repro — l'agent vole à l'aveugle.
  • Entropie architecturale : la génération accélère, le design pourrit aussi — personne n'ose toucher aux frontières de modules.

GSD, BMAD ou Spec-Kit tentent d'envelopper tout le flux agent. La critique de Matt : un processus non décomposable se débugue comme un compilateur cassé. skills va dans l'autre sens — chaque skill est un court Markdown (SKILL.md), déclenché en Slash, empilable comme des briques Lego.

Dans les équipes produit françaises, on voit souvent le même scénario : une user story Jira, l'agent interprète librement, et le vendredi le PR « fonctionne » mais ne correspond pas au refinement. /grill-me force à combler cet écart avant le premier commit.

En une phrase : mattpocock/skills ne vend pas un modèle plus malin, mais des check-lists d'ingénieur reproductibles.

2. Ce qu'est mattpocock/skills

Sous-titre du dépôt : Skills for Real Engineers. Straight from my .claude directory. Distribué via skills.sh, licence MIT, étoiles visibles sur GitHub (rédaction : >100 k). Trois familles :

2.1 Engineering — au quotidien

Commande SlashRôleMoment typique
/grill-me, /grill-with-docsInterroger le besoin ; la variante maintient CONTEXT.md et les ADRAvant toute feature non triviale
/tddRouge-vert-refactor — test qui échoue d'abordLogique métier, bugs
/diagnoseRepro → minimiser → hypothèse → instrumentation → fix → régressionPerf, concurrence
/to-prdCondenser la discussion en PRD + issue GitHubAccord oral, pas de doc
/to-issuesDécouper PRD/plan en issues verticales livrablesAvant le sprint
/improve-codebase-architectureRenforcer les frontières avec le langage métierPassage hebdo sur le repo
/setup-matt-pocock-skillsSource d'issues, labels triage, chemins docsObligatoire après install

2.2 Productivity — collaboration

/caveman réduit les tokens (~75 % selon le README) ; /handoff compresse une session pour le prochain agent ; /write-a-skill crée un skill conforme. Utile pour longues sessions, relais d'équipe ou budget tokens serré.

2.3 Misc — à la demande

/git-guardrails-claude-code bloque via hooks les commandes Git dangereuses (force-push, hard reset). Pre-commit et dossiers d'exercice — pour dépôts sensibles, en parallèle du flux principal.

2.4 Le levier caché de grill-with-docs

Exemple du README : dire « materialization cascade en panne » au lieu de « l'heure a été materialisée ». Une fois le vocabulaire métier dans CONTEXT.md, noms de variables, fichiers et dialogues se raccourcissent. Cela complète notre article sur le graphe de connaissances du code : le graphe structure, CONTEXT.md encode les accords oraux d'équipe.

3. Comparaison avec Cursor Rules, OpenClaw et méthodes lourdes

Tableau de choix, pas de verdict absolu :

Axe mattpocock/skills Cursor / Rules IDE Écosystème OpenClaw GSD / Spec-Kit etc.
Forme Packs Slash installables Fichiers de règles statiques Plugins passerelle + openclaw skills Templates multi-étapes
Force Alignement, TDD, découpage issues, revue archi Style, conventions dossiers Multi-canal, cron, webhooks Récit spec → livraison
Contrôle Élevé — skill par skill Élevé Moyen — ops plus lourdes Faible à moyen
Lien Mac OS-agnostic ; CI iOS/macOS veut souvent un nœud macOS IDE local Souvent Mac résident comme passerelle Selon où tourne l'agent

Face à OpenClaw ClawHub : OpenClaw gère d'où entrent les messages et la santé de la passerelle ; mattpocock/skills gère comment coder ensuite comme un ingénieur. La communauté compare souvent avec addyosmani/agent-skills — plutôt /spec→/ship là-bas, tests et alignement ici. Coexistence dans le même dépôt : courant.

Se souvenir de la semaine dernière : Rules + CONTEXT.md. Faire passer ce patch en TDD : skills de processus. Une fenêtre 200K ne remplace ni l'un ni l'autre — voir contexte long vs collaboration hebdo.

4. Installation en 30 secondes et workflow recommandé

Quickstart officiel — à la racine du vrai dépôt (détails dans le README) :

4.1 Installer

npx skills@latest add mattpocock/skills

L'installateur propose skills et agent cible (Claude Code, Cursor…). Cochez /setup-matt-pocock-skills.

4.2 Configuration dépôt

Dans l'agent :

/setup-matt-pocock-skills

Tracker (GitHub / Linear / fichier local), labels pour /triage, emplacements CONTEXT.md et ADR. Sans cela, /to-issues et /triage produisent des tickets hors habitudes d'équipe.

4.3 Chaîne « feature » reproductible

  1. /grill-with-docs (ou /grill-me) — jusqu'à zéro branche « TBD ».
  2. /to-prd — consensus → PRD + issue.
  3. /to-issues — découpe verticale, pas « semaine front / semaine back ».
  4. Par issue /tdd ; blocage → /diagnose.
  5. Avant release ou le vendredi /improve-codebase-architecture.

4.4 Équipes Apple / Mac

Les skills sont cross-plateforme. Même dépôt avec xcodebuild, signature ou passerelle OpenClaw : schéma fréquent — portable + Cursor avec skills pour le métier, CI et passerelle sur runners Mac auto-hébergés ou Mac distant dédié. LLM locaux : MLX vs Ollama — les skills ne choisissent pas le modèle, ils cadrent l'agent sur le dépôt.

# Exemple : CI existante après install skills (orthogonal)
xcodebuild -project MyApp.xcodeproj -scheme MyApp -destination 'platform=iOS Simulator,name=iPhone 16' build

5. Contre-exemples : quand ne pas tout installer

  • Script jetable ou <50 lignes : /grill-me ralentit — critères d'acceptation suffisent.
  • Pipeline Spec-Kit déjà stable : ne pas casser ; importer /tdd ou /diagnose seuls.
  • Personne ne maintient CONTEXT.md : /grill-with-docs s'atrophie — nommer un responsable doc d'abord.
  • Besoin principal = automation IM/webhook : passerelle OpenClaw d'abord ; mattpocock/skills ne règle pas les canaux.

Les étoiles mesurent la résonance, pas le niveau après install. Avant upgrade, lire le CHANGELOG — surtout setup et modèles d'issues.

Questions fréquentes (FAQ)

Quelle différence entre mattpocock/skills et les Cursor Rules ?

Les Cursor Rules sont surtout des conventions statiques ; mattpocock/skills propose des workflows Slash composables (ex. /grill-me, /tdd) qui imposent étape par étape l'alignement, les tests et le découpage en issues. Les deux coexistent : Rules pour le socle, Skills pour le processus.

Faut-il obligatoirement Claude Code ?

Non. L'installateur skills.sh prend en charge Claude Code, Cursor, Codex et d'autres agents. Vous choisissez l'agent cible à l'installation ; le skill est écrit au format attendu par l'outil.

Que faire juste après l'installation ?

Exécuter /setup-matt-pocock-skills : tracker d'issues (GitHub/Linear/local), labels de triage, chemins CONTEXT.md et ADR. Sans setup, /to-issues et /triage manquent de contexte dépôt.

Est-ce incompatible avec GSD, BMAD ou Spec-Kit ?

Pas forcément. Matt vise des packs modifiables, pas un framework lourd. Si Spec-Kit produit vos PRD, /to-issues peut toujours découper en issues verticales livrables.

Quels trois skills installer en premier ?

La plupart des équipes commencent par /grill-me (ou /grill-with-docs), /tdd et /to-issues. En cas d'incidents Git, ajouter /git-guardrails-claude-code.

Faut-il louer un Mac distant pour faire tourner l'agent ?

TypeScript et front peuvent rester en local ; builds iOS, gros modèles locaux ou passerelles 24/7 (OpenClaw) demandent souvent un macOS dédié. Les Skills régulent le comment ; le Mac distant le où pour la charge macOS.

Conclusion

Le succès de mattpocock/skills montre que les développeurs veulent moins une « fenêtre qui code » et plus des processus auditables, composables et transmissibles. /grill-me bouche les trous d'alignement, /tdd et /diagnose la boucle de feedback, /to-issues transforme les PRD en tâches verticales — un raccourci du vibe vers la discipline.

  • Install : npx skills@latest add mattpocock/skills, puis /setup-matt-pocock-skills.
  • Chaîne par défaut : alignement → PRD → issues → TDD → revue d'architecture régulière.
  • OpenClaw, graphe de connaissances et Mac distant se complètent — ne se remplacent pas.

Pour héberger passerelle agent ou CI iOS sur macOS : accueil Macstripe — Mac Mini M4 dédiés, SSH/VNC, location à la journée. Plus d'articles OpenClaw et infra IA dans le blog développeurs.

Lecture associée