Veteran Engineer Releases Skills to Elevate AI Beyond Vibe Coding 🔗
Composable agent tools restore developer control by embedding rigorous diagnostic and architectural practices into daily AI workflows
The mattpocock/skills repository delivers a focused directory of agent skills that transform how experienced developers interact with AI coding assistants. Extracted directly from creator Matt Pocock's own .claude directory, these skills emphasize disciplined engineering over passive prompting.
The mattpocock/skills repository delivers a focused directory of agent skills that transform how experienced developers interact with AI coding assistants. Extracted directly from creator Matt Pocock's own .claude directory, these skills emphasize disciplined engineering over passive prompting. Rather than letting AI generate code through vague conversation, the project supplies small, adaptable building blocks that keep the engineer in command of both process and outcome.
At the heart of the collection is a clear diagnosis of why most AI-assisted development fails. The most frequent breakdown, Pocock notes, is misalignment: the developer believes the model understands the problem, only to receive an implementation that misses critical constraints or domain nuances. The remedy is the grill-with-docs skill, which forces the agent to conduct a rigorous questioning session. It challenges the proposed plan against the existing domain model, sharpens terminology, updates CONTEXT.md files, and revises architecture decision records on the fly. This single skill alone shifts AI from oracle to collaborative skeptic.
Other skills demonstrate the same precision. The diagnose skill enforces a structured loop familiar to seasoned engineers: reproduce, minimise, hypothesise, instrument, fix, and regression-test. It turns vague "why is this slow?" conversations into reproducible investigative workflows. The improve-codebase-architecture skill scans a project for deepening opportunities by consulting both the domain language captured in CONTEXT.md and the decisions stored in docs/adr/. Meanwhile, tdd brings test-driven development into the AI loop, ensuring the red-green-refactor cycle remains intact rather than dissolving into optimistic code generation. Additional tools such as github-triage apply a label-based state machine to issue management, replacing chaotic backlogs with predictable flow.
What makes the project technically interesting is its deliberate minimalism. Unlike heavyweight frameworks that swallow the entire development process, these skills are intentionally small and composable. Each operates as an independent module that developers can combine, modify, or discard without breaking their workflow. This design reflects decades of real-world engineering experience and directly counters the tendency of some AI methodologies to hide complexity inside opaque automation layers. When a skill produces an unexpected result, the engineer can inspect, tweak, or replace it immediately.
Installation takes less than 30 seconds. Running npx skills@latest add mattpocock/skills connects the directory to popular coding agents, letting developers select exactly which skills they want active. The lightweight approach has struck a chord with engineers who value control. Instead of surrendering their process to an autonomous "AI engineer," they now possess a growing library of battle-tested techniques that amplify their own expertise.
As AI coding tools proliferate, mattpocock/skills represents a maturing philosophy: treat the agent as an extraordinarily capable junior colleague who still requires guidance, questioning, and accountability. The skills do not remove the difficulty of building software; they make that difficulty visible, manageable, and improvable. For developers tired of impressive-looking but brittle AI output, the repository offers a path toward genuinely robust, thoughtfully architected systems created with AI as a genuine partner rather than a replacement.
The project continues to evolve, with Pocock regularly adding new skills drawn from production experience. Its emergence signals a broader shift in the AI developer community toward tools that respect engineering craft instead of attempting to bypass it.
- Senior engineers diagnosing stubborn production bugs systematically
- Architects improving codebase structure using domain models and ADRs
- Teams aligning requirements through rigorous AI grilling sessions
- aider - Enables conversational AI pair programming but lacks structured diagnostic and architecture skills
- continue-dev - Offers open-source AI autopilot for IDEs without composable engineering methodologies
- cursor-rules - Provides custom rulesets for AI editors but does not embed decades-tested process loops