Skills For Real Engineers
lastmod 2026-11-17created 2026-11-171 edits
Skills For Real Engineers is a repository (mattpocock/skills) in which Matt Pocock publishes the coding agent skills he uses every day. Unlike approaches such as GSD, BMAD, and Spec-Kit that take over the entire development process, it is designed so that users pick and combine small, easily modified skills. It is organized around four failures—the agent misunderstanding the request, being too verbose, producing code that doesn't work, and turning the codebase into a big ball of mud—countered respectively by interviews, a shared glossary, TDD, and module design.
About
- The author's headline skills are
/grill-meand/grill-with-docs. Before starting work, the agent keeps asking questions until every branch of the plan and design is settled -
/grill-with-docsrefines project terminology during the interview and updatesGLOSSARY.mdand ADRs on the spot. It applies the ubiquitous language of Domain-driven design to agents; the reasoning is that shared terminology shortens explanations and keeps naming consistent - Skills are split into user-invoked ones that the user calls directly (flow orchestration) and model-invoked ones that the agent may also call when appropriate (reusable discipline). User-invoked skills do not call one another
- Engineering:
/to-spec,/to-tickets,/implement,/implement-spec,/triage,/wayfinder,/retro,tdd,diagnosing-bugs,code-review,prototype, etc. - Productivity:
/handoff(compresses the conversation into a document so another agent can take over),/teach,/wait-what,/to-questionnaire,writing-for-agents, etc. -
tddimplements one vertical slice at a time with red-green-refactor.code-reviewhas two subagents review separately along two axes: the repository's coding standards and the original spec -
/improve-codebase-architecturefinds candidates for deepening modules, presents them in an HTML report, and digs into the chosen candidate through an interview. Recommended to run every few days - The
mattpocock-skillsplugin contains 27 skills. After installing, run/setup-matt-pocock-skillsonce per repository to set the issue tracker (GitHub, GitLab, local files, etc.), triage labels, and where documents are stored - For Claude Code:
claude plugin install mattpocock-skills@claude-plugins-official. There are also install commands for Codex, GitHub Copilot, and Gemini CLI; for other agents,npx skills@latest add mattpocock/skills - MIT license