skills

Skills for Real Engineers est un dépôt créé par Matt Pocock qui regroupe des compétences d'agents destinées à l'ingénierie logicielle quotidienne avec des agents de codage IA. Elles sont partagées depuis le répertoire .agents de l'auteur et conçues pour être petites, adaptables, composables et indépendantes du modèle. L'auteur les distingue d'approches plus volumineuses qui contrôlent l'ensemble du processus, comme GSD, BMAD et Spec-Kit, en affirmant que celles-ci retirent le contrôle au développeur ; ces compétences visent plutôt à s'insérer dans les flux de travail existants. L'installation propose deux options : un plugin Claude Code installe l'ensemble complet sous forme de paquet géré, en lecture seule et mis à jour automatiquement, tandis que l'installateur skills.sh copie des fichiers de compétences modifiables dans un projet afin que les utilisateurs puissent les adapter. Après l'installation, une compétence de configuration (setup-matt-pocock-skills) est exécutée une fois par dépôt pour configurer l'outil de suivi des tickets (GitHub, Linear ou fichiers locaux), les étiquettes de triage et l'emplacement de la documentation. La motivation affichée du dépôt est de corriger des modes d'échec courants des agents de codage : - Le décalage entre ce que l'utilisateur veut et ce que l'agent construit, traité par des sessions de questionnement approfondi qui interrogent le plan avant le début du travail (grill-me, grill-with-docs). - La verbosité des sorties de l'agent, traitée par la construction d'un langage de domaine partagé documenté dans CONTEXT.md et des ADR, afin que les agents raisonnent et communiquent plus succinctement. - Le code qui ne fonctionne pas, traité par des boucles de retour : types statiques, accès au navigateur et tests automatisés, incluant une compétence TDD red-green-refactor et une boucle de diagnostic de bugs par étapes. - La dégradation de l'architecture, traitée par des compétences axées sur la conception qui encouragent des modules profonds et des évaluations régulières de l'architecture de la base de code. Les compétences sont organisées en deux grandes catégories : Les compétences d'ingénierie incluent des commandes invoquées par l'utilisateur telles que ask-matt (un routeur vers les compétences), grill-with-docs, triage, improve-codebase-architecture, to-spec, to-tickets, implement et wayfinder. Les compétences d'ingénierie invoquées par le modèle incluent prototype, diagnosing-bugs, research, tdd, domain-modeling, codebase-design, code-review, resolving-merge-conflicts et wizard. Les compétences invoquées par le modèle peuvent être appelées automatiquement par l'agent lorsque cela est approprié ; les compétences invoquées par l'utilisateur orchestrent les flux de travail et peuvent invoquer des compétences appelées par le modèle. Les compétences de productivité, utilisables au-delà du codage, incluent des commandes invoquées par l'utilisateur comme grill-me, handoff, teach, to-questionnaire et wait-what, ainsi que la primitive réutilisable d'entretien grilling et writing-for-agents pour produire une documentation lisible par les agents, comme AGENTS.md et CLAUDE.md. L'auteur propose une newsletter pour rester informé des évolutions des compétences. Le dépôt documente également des décisions de conception, notamment celle de la distribution sous forme de plugin Claude Code, dans un répertoire ADR. Dans l'ensemble, il s'agit d'une bibliothèque pratique de pratiques d'ingénierie reproductibles, encodées sous forme de commandes slash et de compétences appelables par l'agent, destinée aux développeurs qui souhaitent garder davantage de contrôle sur la manière dont les agents IA écrivent des logiciels.