Skills For Real Engineers : le guide complet de la bibliothèque de skills IA de Matt Pocock

Qu'est-ce que Skills For Real Engineers ?

En une phrase : Skills For Real Engineers (dépôt Matt Pocock Skills) est une bibliothèque de skills pour agents IA destinée aux ingénieurs professionnels, créée par Matt Pocock à partir de sa pratique quotidienne du répertoire .claude.

Sa position est claire : ce n'est pas un jouet pour le « vibe coding », mais une boîte à outils quotidienne pour « faire du vrai travail d'ingénierie ». L'auteur explique avoir conçu ces skills pour corriger les modes de défaillance courants qu'il rencontre avec les agents de codage comme Claude Code et Codex.

Différence avec GSD et BMAD

Les approches comme GSD, BMAD et Spec-Kit tentent de « prendre en charge le processus ». Ce faisant, elles vous retirent aussi le contrôle, et un problème dans le processus devient difficile à localiser. Skills For Real Engineers suit la voie inverse :

• Petit mais efficace : chaque skill est utilisable indépendamment, sans framework global.
• Composable : on choisit, on découpe et on adapte à son propre dépôt.
• Hackable : les skills sont de simples fichiers dans votre dépôt ; si quelque chose ne vous plaît pas, modifiez-le.
• Indépendant du modèle : aucun modèle imposé, fonctionne avec Claude, Codex, Cursor, etc.
• Fondé sur l'ingénierie : s'appuie sur des principes classiques comme ceux de The Pragmatic Programmer et Domain-Driven Design, plutôt que sur des astuces de prompt.

Positionnement du produit

Il s'adresse aux développeurs ayant déjà de vraies habitudes d'ingénierie : typer statiquement, tests automatisés, refactorisation rouge-vert et autres retours concrets pour contraindre l'agent et éviter qu'il « vole à l'aveugle ». La bibliothèque n'est pas un service hébergé et ne décide pas de l'architecture à votre place : elle fournit un ensemble d'interfaces réutilisables de conversation et de processus.

Fonctionnalités principales

Les skills sont fournies à l'agent sous forme de commandes slash, regroupées par thème.

Alignement des besoins

• /grill-me : une session de questions-réponses intensive pour aligner complètement les besoins et les branches de décision avant d'écrire du code ; utilisable aussi hors contexte de code.
• /grill-with-docs : sur la base du grilling, construit en plus un langage partagé pour le projet et des enregistrements de décisions d'architecture (ADR).
• /zoom-out : demande à l'agent de sortir du code local et de fournir une explication depuis une vue système globale.

Développement et validation

• /tdd : pilote l'agent dans le cycle rouge-vert-refactor, en construisant chaque fonctionnalité ou correction par tranche verticale.
• /diagnose : boucle de diagnostic normalisée : reproduire → minimiser → hypothèse → instrumenter → corriger → test de régression.
• /prototype : construit rapidement un prototype terminal exécutable ou plusieurs variantes d'interface pour valider un design.

Tâches et planification

• /triage : trie et répartit les issues selon une machine à états, avec un vocabulaire d'étiquettes personnalisable.
• /to-prd : synthétise automatiquement le contexte de la conversation en cours en un PRD et le soumet comme issue GitHub.
• /to-issues : découpe un plan ou un PRD en tâches par tranches verticales pouvant être prises indépendamment.

Architecture et collaboration

• /improve-codebase-architecture : identifie les opportunités d'approfondissement des modules à partir de CONTEXT.md et des ADR, pour traiter la boule de boue architecturale.
• /caveman : mode de communication extrêmement compressé, réduisant d'environ 75 % la consommation de tokens tout en conservant la précision technique.
• /handoff : compresse la session en cours en un document de passation, pour qu'un autre agent puisse reprendre le travail sans couture.
• /teach : utilise le répertoire courant comme espace d'enseignement à états, pour apprendre une nouvelle compétence ou un concept sur plusieurs sessions.
• /write-a-skill : crée une nouvelle skill selon une structure normalisée, avec divulgation progressive et regroupement de ressources.

Mécanisme de langage partagé

L'établissement d'un vocabulaire projet via CONTEXT.md est l'approche que l'auteur estime la plus puissante de cet ensemble. Le constat : un agent est généralement parachuté dans un projet et doit deviner le jargon en avançant ; il utilise alors 20 mots là où un seul suffirait.

Exemple : transformer « un problème quand une leçon dans une section d'un cours devient réelle » en « un problème dans la cascade de matérialisation » permet d'économiser beaucoup d'explications d'un seul coup, et cette concision porte ses fruits session après session. Le langage partagé apporte aussi : des noms de variables, fonctions et fichiers cohérents ; un codebase plus facile à naviguer pour l'agent ; et moins de tokens consommés par l'agent pour raisonner.

Comment utiliser Skills For Real Engineers

Il existe deux chemins d'entrée, correspondant à deux philosophies. Il faut en choisir un seul.

Chemin 1 : le plugin Claude Code

• Toute la collection est installée comme un bundle géré en lecture seule ; quand l'auteur publie une mise à jour, elle arrive automatiquement. C'est un modèle « abonnement » plutôt qu'un fork.
• Il est déjà présent dans la place de marché officielle de Claude Code : rien à ajouter au préalable, mises à jour automatiques.
• Un plugin Codex natif est sur la feuille de route (voir .agents/adr/0002-ship-as-a-claude-code-plugin.md).

Chemin 2 : l'installeur skills

Exécutez npx skills@latest add mattpocock/skills, choisissez l'agent cible et cochez /setup-matt-pocock-skills. L'installeur vous laisse sélectionner les skills et les agents de codage sur lesquels les installer ; les skills sont écrites dans votre dépôt comme des fichiers ordinaires que vous possédez et pouvez modifier. Rien ne se met à jour en arrière-plan ; tirez les dernières modifications quand vous voulez avec npx skills update.

Attention : installer les deux chemins à la fois laisse chaque skill en double.

Initialisation et rythme quotidien

1. Exécutez une fois /setup-matt-pocock-skills dans l'agent, une fois par dépôt. Il demandera : quel suivi d'issues utiliser (GitHub, Linear ou fichiers locaux) ; quelles étiquettes appliquer lors du tri (/triage en dépend) ; où enregistrer les documents générés.
2. Avant chaque changement, utilisez /grill-me ou /grill-with-docs pour aligner les besoins.
3. Pendant le développement, /tdd garantit la qualité.
4. En cas de bug, /diagnose lance le diagnostic normalisé.
5. Pour l'architecture, exécutez régulièrement /improve-codebase-architecture pour prévenir la dégradation du code.

L'installation et la configuration complètes prennent environ 30 secondes, avec GitHub, Linear ou des fichiers locaux comme suivi d'issues.

Cas d'usage

• Alignement des besoins et planification : au démarrage d'un projet ou avant un changement de fonctionnalité, utilisez /grill-me ou /grill-with-docs pour un questionnement intense, afin que besoins, branches de décision et terminologie métier soient totalement alignés.
• Développement piloté par les tests : pour garantir la qualité, utilisez /tdd pour faire exécuter à l'agent le cycle rouge-vert-refactor, en construisant chaque fonctionnalité ou correction par tranche verticale, avec un test automatisé qui protège chaque changement.
• Diagnostic de bugs complexes : face à une régression de performance ou un défaut logique difficile à reproduire, lancez /diagnose pour suivre toute la boucle de diagnostic.
• Gouvernance continue de l'architecture : dans les grandes bases de code maintenues sur le long terme, exécutez régulièrement /improve-codebase-architecture pour identifier les opportunités d'approfondissement des modules à partir de CONTEXT.md et des ADR, et éviter que l'agent n'accélère la dégradation.
• Collaboration entre sessions : compressez la session avec /handoff et réduisez les tokens avec /caveman, utile pour les longues tâches et les relais entre plusieurs personnes ou agents.

Points forts

• Léger et composable : pas de framework lourd, chaque skill est indépendante et adaptable.
• Indépendant du modèle : fonctionne avec Claude, Codex, Cursor, etc.
• Fondé sur l'ingénierie : construit sur des principes d'ingénierie classiques, pas sur des astuces de prompt.
• Langage partagé : CONTEXT.md réduit nettement les coûts de communication avec l'agent et la consommation de tokens.
• Boucle de feedback : insiste sur les retours concrets comme le typage statique, les tests automatisés et la refactorisation rouge-vert.
• Facile à modifier : avec le chemin skills, les skills sont des fichiers éditables dans votre dépôt.

Limites

• C'est un ensemble de skills, pas un gestionnaire de processus de bout en bout ; les équipes sans langage partagé ni discipline ADR doivent maintenir elles-mêmes CONTEXT.md et les enregistrements de décisions.
• Le système d'étiquettes de /triage dépend de la configuration d'initialisation ; une mauvaise configuration peut affecter la qualité du tri.
• Les deux chemins d'installation sont mutuellement exclusifs ; les mélanger crée des skills en double.
• Le plugin Codex natif est encore sur la feuille de route ; les utilisateurs de Codex passent actuellement par l'installation de fichiers de skills.
• Le périmètre précis du support, les détails des commandes et le rythme des mises à jour peuvent évoluer.

Vérification du prix et de la disponibilité

La fiche factuelle fournie ne contient aucune information sur les prix, les frais d'abonnement ou les conditions de licence. Aucune hypothèse n'est donc faite. Pour savoir si l'outil est payant, quel est son mode de licence, quels canaux d'installation sont disponibles et quelle est la version la plus récente, consultez directement le site officiel https://github.com/mattpocock/skills et la page de la place de marché de l'agent que vous utilisez.

Questions fréquentes (FAQ)

Est-ce lié à un modèle particulier ?

Non. La formulation officielle est que l'ensemble est indépendant du modèle : Claude, Codex, Cursor, etc., peuvent l'utiliser.

Est-ce utilisable immédiatement après installation ?

Une initialisation est nécessaire. Exécutez une fois /setup-matt-pocock-skills dans l'agent pour configurer le suivi d'issues, les étiquettes de tri et le répertoire des documents ; ensuite, des skills comme /triage fonctionneront selon vos conventions.

Plugin ou installeur, que choisir ?

Pour suivre les mises à jour de l'auteur et accepter un paquet géré en lecture seule, choisissez le plugin Claude Code. Pour posséder et modifier les fichiers, et contrôler vous-même le moment des mises à jour, utilisez npx skills@latest add mattpocock/skills. Évitez d'installer les deux.

Est-ce en conflit avec GSD ou BMAD ?

L'intention de l'auteur est de proposer une alternative : GSD, BMAD et Spec-Kit aident en prenant en charge le processus, mais retirent aussi le contrôle et rendent les problèmes internes difficiles à résoudre ; ces skills misent sur la simplicité, la composabilité et le caractère hackable. Leur utilisation conjointe dépend de la discipline de votre équipe.

Quelle skill essayer en premier ?

L'auteur considère /grill-with-docs comme peut-être la technique la plus puissante du dépôt : c'est à la fois une session de questionnement intense, une aide pour construire un langage partagé avec l'IA et un moyen de consigner dans des ADR les décisions difficiles à expliquer.

Alternatives

• GSD, BMAD, Spec-Kit : frameworks lourds qui cherchent à prendre en charge le processus de développement ; moins de contrôle, problèmes de processus plus difficiles à localiser.
• Agent Skill open source de Yize Eze : se concentre sur la manière de « naviguer sur Internet ».
• Framework de compétences agentiques et plugin de méthodologie de développement open source de Jesse Vincent.
• Skill de design IA open source conçue pour les assistants de codage IA.
• Approche générale : maintenir soi-même un ensemble de fichiers de skills .claude ou au niveau du projet, assemblés selon les habitudes de l'équipe.

Sources primaires

• Site officiel et dépôt : https://github.com/mattpocock/skills

Pour suivre l'évolution de ces skills et les nouvelles skills créées par l'auteur, vous pouvez rejoindre sa newsletter, suivie par environ 60 000 développeurs.