Key takeaways

  • Stop agents building the wrong thing: a grilling skill makes the agent question you before it writes code.
  • Cut the waffle: a shared-language document helps agents decode your project's jargon.
  • Get feedback into the loop: a test-driven skill and a bug-diagnosis skill give the agent something to check against.
  • Works with any model, and the skills are MIT licensed and designed to be small and composable.
  • The catches: it is opinionated, some install routes need manual updates, and the design skill is a survey, not a rescue.

What it is

The repository is a set of agent skills that its author says he uses every day to do real engineering, not vibe coding. It is released under the MIT licence and lives on GitHub at mattpocock/skills.

The problem it solves

The author built the skills to fix common failure modes he sees with Claude Code, Codex and other coding agents. The most common, he says, is misalignment: you think the agent knows what you want, then see what it built.

Other frameworks try to help by owning the whole process. The README argues that takes away your control and makes bugs hard to resolve. These skills take the opposite line and stay small.

What you get

  • Fewer wrong turns: a grilling session has the agent ask detailed questions about what you are building before it starts.
  • Less waffle: a shared-language document helps agents decode the jargon used in your project.
  • Better feedback: a test-driven skill encourages red-green-refactor, and a diagnosis skill covers hard bugs and performance regressions.
  • Pick and mix: the skills are designed to be small, easy to adapt and composable, and they work with any model.
  • Fits your workflow: a setup step asks which issue tracker you use, including GitHub, GitLab or local files.

The catches

  • Opinionated: this is one engineer's way of working, so expect to adapt it.
  • Updates: one install route copies editable files into your project and you update them by hand.
  • Pick one route per agent: installing both gives you every skill twice.
  • Limits: the architecture skill is a survey, not a rescue, and will not untangle an old codebase for you.

What we did not test

We did not install the skills or run them with any agent. Every claim here comes from a literal quote in the project's README or the GitHub API, and the benefits described are the author's own.

Verdict

Editors' view: this suits developers who already work with a coding agent and keep getting results that miss the brief. If you want a fixed, end-to-end process, it may feel too loose. Try a few skills on a small project first.

Repository
mattpocock/skills
Shell · MIT
View on GitHub ↗

Sources

Need help adopting this, or have a software project in mind?

Tell us what you are building. The initial consultation is free. Email [email protected] or follow @zolnaltd.

Start a conversation →