Skills For Real Engineers - Matt Pocock

Recueil de compétences d’agent de Matt Pocock, une boîte à outils pour l’ingénierie concrète plutôt que le vibe coding

Ce dépôt est un projet publié par Matt Pocock, bien connu comme formateur TypeScript, qui rassemble les compétences d’agent qu’il utilise chaque jour avec Claude Code, c’est-à-dire des commandes slash et des règles de conduite. Son slogan est « Skills For Real Engineers », et l’auteur estime que des frameworks comme GSD, BMAD ou Spec-Kit, qui prennent en charge l’ensemble du processus, privent les développeurs de contrôle et compliquent le suivi quand des défauts apparaissent. En alternative, il propose une approche par outils unitaires, petits, interchangeables et combinables avec n’importe quel modèle. En parcourant réellement la codebase, on voit que les skills sont répartis sous skills/ dans des buckets comme engineering, productivity, misc, personal, in-progress et deprecated, et que chaque skill est géré comme une unité indépendante avec son propre SKILL.md.

• Simplicité du chemin d’installation : installation en une seule ligne avec npx skills@latest add mattpocock/skills, puis configuration en une fois du type d’issue tracker, du vocabulaire de labels utilisé pour le triage et de l’emplacement de stockage de la documentation via /setup-matt-pocock-skills. Une seule exécution par dépôt suffit, et les autres skills partagent ensuite cette configuration.

• Une intention de conception qui résume quatre modes d’échec des agents : le premier est un problème d’alignement, celui de « ne pas construire ce qu’on veut », pour lequel grill-me et grill-with-docs imposent une session d’entretien qui pousse l’intention jusqu’au bout. Le deuxième est le problème de « l’agent trop verbeux » ; la création d’un CONTEXT.md, sorte de dictionnaire des termes métier, réduit à la fois le gaspillage de tokens et les problèmes de cohérence de nommage. Le troisième est le problème de « code qui ne fonctionne pas » ; tdd prend en charge la boucle red-green-refactor, tandis que diagnose gère la boucle de débogage allant de la reproduction jusqu’aux tests de régression. Le quatrième est celui du « code devenu une boule de boue », où to-prd, zoom-out et improve-codebase-architecture servent à rétablir les frontières modulaires et la vision d’ensemble du système.

• Une approche différenciante dans la gestion du langage partagé : le projet va plus loin qu’une simple aide au codage et accorde une importance particulière à l’alignement explicite du vocabulaire entre l’agent et les humains. Le CONTEXT.md présenté en exemple pour course-video-manager compresse par exemple le « problème du moment où une leçon dans une section dans un cours obtient sa place dans le système de fichiers » en un seul terme, « materialization cascade », afin de réduire à la fois les tokens consommés et le coût cognitif à chaque répétition de la même conversation.

• Le côté pratique des skills secondaires : pour les workflows quotidiens, on trouve caveman (un mode de réponse compressé visant environ 75 % de réduction de tokens) et write-a-skill (une méta-skill pour créer des skills), tandis que l’ensemble d’outils auxiliaires comprend notamment git-guardrails-claude-code (configuration de hooks pour bloquer à l’avance les commandes git dangereuses) et setup-pre-commit (configuration pre-commit basée sur Husky + lint-staged). L’approche consiste ainsi à découper en petits outils même les domaines situés au-delà de la simple écriture de code.

• Les règles d’exploitation du dépôt lui-même : les skills placées dans engineering, productivity et misc doivent obligatoirement être enregistrées dans le README racine ainsi que dans .claude-plugin/plugin.json, tandis que l’enregistrement est interdit pour personal, in-progress et deprecated, ce qui impose le périmètre de publication au niveau du code. La présence de documents ADR dans un répertoire séparé et de scripts shell dédiés aux liens de skills dans scripts/ se lit comme une prolongation de cette même discipline.

Dans l’ensemble, ce projet prend ses distances avec l’automatisation intégrée du type « l’agent s’occupe de tout tout seul » et ressemble davantage à une transposition, sous forme de petites commandes slash interchangeables, de principes d’ingénierie classiques issus de Pragmatic Programmer, Domain-Driven Design, Extreme Programming ou A Philosophy of Software Design. Pour les utilisateurs qui attendaient un outil spectaculaire d’automatisation de workflow, l’ensemble pourra paraître assez sobre ; mais comme tentative de ramener dans les outils du quotidien les fondamentaux que sont l’alignement, le langage partagé, les boucles de feedback et la conception modulaire, à l’ère des agents, le projet présente une texture bien plus proche de la pratique réelle.