AI-agents temmen met Matt Pocock's Skills Toolkit

Wanneer ontwikkelaars intensief beginnen te werken met Claude Code of Codex, stuiten ze snel op hetzelfde probleem. De agent gaat enthousiast akkoord met de taak, gaat vijf minuten code schrijven en komt terug met vijfhonderd regels gebroken spaghetti. Bekend? Matt Pocock, de auteur van Total TypeScript, besloot dit probleem aan te pakken met engineering-disciplines en stelde een repository samen van praktische instructies (skills) voor AI-agents. En het vinvcn/mattpocock-skills-zh-CN project paste deze hele toolkit aan voor het werken met Chinese taalmodellen en gemengde contexten.

Dit gaat niet over abstracte discussies over de toekomst van ontwikkeling. Het is een set concrete commando's en scenario's die het taalmodel laten optreden als een nette mid-level of senior ontwikkelaar, in plaats van als een willekeurige functiegenerator.

Vier scenario's waarin agents typisch falen

Matt identificeerde typische valkuilen waar ontwikkelaars tegenaan lopen bij het overdragen van taken aan AI, en schreef een apart werkprotocol voor elk geval.

De agent doet iets totaal anders dan wat er gevraagd werd

De meest voorkomende ontwikkelingshoofdpijn wordt verwachtingsmismatch genoemd. Een persoon bedenkt de ene architectuur, het model vult details in naar eigen smaak. Om deze kloof te dichten, bedacht de auteur het /grill-me commando (en de engineering variant /grill-with-docs).

Voordat de agent enige code aanraakt, voert het een formeel verhoor uit. Het stelt een reeks gerichte vragen over edge cases, datastructuur en interface-vereisten. Het model schrijft geen enkele regel tot de beslissingsboom convergeert. Dit bespaart uren aan herschrijven van code.

Het model verspilt context aan onnodig gebabbel

Wanneer een agent een onbekend project betreedt, begint het zijn eigen terminologie te verzinnen en tientallen tokens te besteden aan het uitleggen van voor de hand liggende zaken. De oplossing ligt in het creëren van een document met een uniforme domeinwoordenlijst (in het project wordt het CONTEXT.md genoemd).

Het /grill-with-docs commando peilt niet alleen, maar legt ook direct projectterminologie en architectuurbeslissingen (ADRs) vast. Zodra jij en de agent een gemeenschappelijke taal delen, krimpt de dialoog dramatisch in, en worden variabelen in code consistent genoemd in alle modules.

Gegenereerde code draait niet

Wanneer een model code schrijft zonder feedback, werkt het blind. Het heeft tests nodig. De /tdd skill dwingt de agent strikt de red-green-refactor cyclus te volgen. Eerst schrijft het model een falende unit test, dan implementeert het precies genoeg code om de test te laten slagen, en pas daarna ruimt het op.

Voor complexe bugs is er een apart /diagnosing-bugs scenario. Het begeleidt het model door een strikt protocol: reproduceer de fout met een test, vernauw het zoekgebied, formuleer een hypothese, voeg logging toe, repareer de code en voer een regressietest uit.

Architectuur verandert in een rommeltje

De snelheid van codegeneratie voedt entropiegroei. Om te voorkomen dat het project één verwarde bal van spaghetti wordt, wordt het /improve-codebase-architecture commando gebruikt.

Het scant het project, zoekt naar kandidaten voor diepe modules (met eenvoudige publieke interfaces en verborgen complexe logica) en genereert een rapport. Essentieel is het een reguliere codekwaliteitsaudit direct in de terminal.

Waarom lokaliseren naar het Chinees

De oorspronkelijke repository is in het Engels geschreven, maar vinvcn's lokalisatie heeft een interessant technisch doel. Het gaat niet alleen om gemak voor Chinese ontwikkelaars.

Bij het werken met Aziatische LLMs zoals Qwen of DeepSeek verminderen Chinese systeemprompts en instructies contextverlies. Het model raakt minder in de war door formuleringnuances. Ondertussen blijven alle identifiers, commandonamen, bestandspaden en configuratiesleutels in het Engels. Er gaat niets kapot bij het uitvoeren van scripts.

Hoe de skills-architectuur werkt

Alle skills in de repository vallen in twee categorieën:

1. Door de gebruiker geactiveerde commando's. Alleen mensen activeren deze handmatig via slash. Bijvoorbeeld, /ask-matt helpt de juiste skill te selecteren voor de huidige taak, /to-spec compileert discussie naar een ticket, en /wayfinder plant een grote feature verschillende sessies vooruit.
2. Door het model geactiveerde skills. Zowel de gebruiker als de agent kunnen deze op eigen initiatief activeren wanneer het een geschikte subtaak ziet. Deze omvatten de TDD-cyclus, git conflict-oplossing zonder harde aborts, code review en het opstellen van documenten.

Skills zijn geschreven als eenvoudige Markdown-bestanden met instructies. Ze zijn gemakkelijk te lezen en kunnen worden bewerkt om te passen bij de regels van je team.

Installatie in een paar minuten

Je kunt skills aan je project toevoegen met de skills.sh installer:

npx skills@latest add vinvcn/mattpocock-skills-zh-CN

Het hulpprogramma vraagt welke skills je wilt kopiëren en in welke agent directories je ze wilt registreren. Zorg ervoor dat je /setup-matt-pocock-skills selecteert.

Na installatie voer je de initiële setup uit direct in de agent dialoog:

/setup-matt-pocock-skills

De agent verduidelijkt waar je taken bijhoudt (GitHub Issues, Linear of lokale bestanden), welke labels je gebruikt voor triage en in welke map je architectuurdocumentatie opslaat.

Als je werkt in Claude Code en geen bestandskopieën in elke repository wilt opslaan, kun je skills als plugin verbinden:

claude plugin marketplace add vinvcn/mattpocock-skills-zh-CN
claude plugin install mattpocock-skills@mattpocock

In deze modus worden skills centraal bijgewerkt wanneer nieuwe versies uitkomen.

Voor wie is dit

Twee categorieën engineers moeten deze repository bekijken.

Ten eerste degenen die actief Claude Code, Codex of OpenCodeInterpreter gebruiken en genoeg hebben van het bestrijden van modelhallucinaties. Matt Pocock's aanpak brengt voorspelbaarheid terug naar ontwikkeling door strikte beperkingen en korte feedback loops.

Ten tweede is het een uitstekend voorbeeld van hoe je systeeminstructies voor AI-assistenten schrijft. Zelfs als je de Chinese vertaling niet nodig hebt, biedt de bestandsstructuur in deze repository een duidelijke les in het ontwerpen van skills voor agents. Probeer een paar commando's zoals /grill-me op te nemen in je dagelijkse workflow, en je zult tegen de avond het verschil merken.