Matt Pocock open-sourced his .agents directory, a Claude Code skills setup for production engineering. The release targets the misalignment problem that plagues agent coding workflows.
Key facts
- Matt Pocock open-sourced his .agents directory
- Includes /grill-me, /grill-with-docs, /tdd skills
- /diagnosing-bugs: reproduce, minimise, hypothesise, fix
- Installable as auto-updating Claude Code plugin
- CONTEXT.md builds shared domain language
Matt Pocock, a well-known TypeScript educator and developer, has open-sourced his entire .agents directory — the exact skills configuration he uses daily for real engineering work, not vibe coding According to @_vmlops. The release is a direct response to the gap between demo-grade agent demos and production-grade agent workflows.
What's in the directory
The setup includes five core skill definitions. The /grill-me and /grill-with-docs commands interrogate the agent's plan before any code is written, explicitly designed to kill the misalignment problem where agents charge off in the wrong direction. The /tdd skill enforces red-green-refactor loops, giving agents real feedback instead of flying blind. A /diagnosing-bugs skill structures debugging as a repeatable loop: reproduce, minimise, hypothesise, instrument, fix. Finally, /improve-codebase-architecture scans for entropy and generates a visual report before any refactoring begins.
The directory also includes a CONTEXT.md pattern that builds a shared domain language, so the agent stops using 20 words where one will do. This addresses a common failure mode where agents produce verbose, inconsistent terminology that degrades output quality over long sessions.
Installation and distribution
Users can install the setup as a Claude Code plugin with auto-updates, or fork the files directly from the linked repository. Pocock did not disclose usage metrics or adoption numbers, and the source tweet does not specify license terms beyond the open-source framing.
Why this matters
The significance here is less about the specific prompts and more about the pattern: a prominent developer publishing their daily agent configuration as a reusable artifact. This mirrors the shift from hand-written prompts to structured, version-controlled skill directories. The /grill-me pattern in particular highlights the growing recognition that the bottleneck in agent coding isn't code generation — it's plan validation. By forcing the agent to defend its approach before writing code, Pocock is treating the agent like a junior engineer who needs code review, not an oracle.
What to watch
Watch for community forks and adaptations of the /grill-me pattern into other agent frameworks like Cursor or Windsurf. Also track whether Anthropic officially features this directory in Claude Code documentation, which would signal endorsement of structured skill directories as best practice. Adoption metrics on GitHub will show if the pattern sticks.
