PluginInstalls cleanly

Plan, test and debug before you build

Skills For Real Engineers (mattpocock-skills)

Matt Pocock's skills make your assistant ask you questions before it codes, write tests first, track down bugs step by step and review its own changes.

Works with
Claude Code, Codex CLI, Gemini CLI
Good for
Build an app

What it does

This is a set of 27 skills (instruction files) from Matt Pocock, version 1.3.1. They fix the most common ways an AI assistant goes wrong: it builds the wrong thing, it talks too much, its code doesn't work, or the project turns into a mess.

The best-known skill is grill-me. Before any code is written, the assistant asks you detailed questions until it understands what you want. Others write a plan (to-spec), split it into tasks (to-tickets), build with tests first (tdd), hunt bugs in clear steps (diagnosing-bugs) and review the result (code-review).

The author says these skills are for real engineering, not vibe coding. For a beginner, the planning and debugging skills are the easiest place to start, because they slow the assistant down and make it check its work.

Some skills change files and accounts outside the code you asked for:

  • setup-matt-pocock-skills asks which issue tracker you use (GitHub, GitLab, local files or another you describe). It edits your CLAUDE.md or AGENTS.md, adds files under docs/agents/, and creates labels on GitHub or GitLab when you use those trackers.
  • to-tickets publishes tickets to your tracker. triage changes labels, posts comments and can close issues, after it confirms with you.
  • implement commits to your current branch. implement-spec runs helper agents in separate git worktrees, merges their work into one branch and can open a draft pull request.
  • wizard writes scripts that put values into .env files or GitHub secrets. handoff saves a summary of your chat in a temporary folder.

We installed the Claude Code plugin in our sandbox. We did not test the two Codex lines or the two Gemini CLI lines. The Codex lines come from the README; the repo has only a Claude-format marketplace file, so we have not checked that Codex accepts it.

Who it is for

People who want the assistant to plan, test and check its work before it builds, not only to write code fast.

Example prompts

  • "/grill-me I want to add a booking form to my site."
  • "Use to-spec to write a plan for this feature, then to-tickets to split it up."
  • "Use diagnosing-bugs to find why the checkout page crashes."
  • "Use tdd to build the price calculator: write a failing test first."
  • "Run code-review on what you just changed."

How to install

claude plugin install mattpocock-skills@claude-plugins-official
codex plugin marketplace add mattpocock/skills
codex plugin add mattpocock-skills@mattpocock
gemini skills install https://github.com/mattpocock/skills.git --path skills/engineering
gemini skills install https://github.com/mattpocock/skills.git --path skills/productivity

How to use it

Run /setup-matt-pocock-skills once in each project. Then type /grill-me before a new feature, or ask: Use diagnosing-bugs to find why the login page crashes.

Check it works

  1. In Claude Code, run /plugin and look for mattpocock-skills.
  2. Run /setup-matt-pocock-skills in your project. It asks about your issue tracker, labels and where to save documents (README).

Common problems

  • Every skill shows up twice — no error text — you installed both the plugin and the skills.sh copy. The README says to pick one per assistant.
  • A skill asks for an issue tracker it does not know — no error text — run /setup-matt-pocock-skills first (CHANGELOG 1.3.0).
  • Gemini CLI skills are old — no error text — Gemini installs do not update themselves. Run both install lines again (README).

What to watch out for

  • The setup skill edits your CLAUDE.md or AGENTS.md, adds files under docs/agents/, and creates labels on GitHub or GitLab when you use those trackers (setup-matt-pocock-skills SKILL.md)
  • to-tickets publishes tickets to your tracker, and triage changes labels, posts comments and can close issues after it confirms with you
  • implement commits to your current branch, and implement-spec runs helper agents in separate git worktrees, merges their work into one branch and can open a draft pull request (CHANGELOG 1.3.0)
  • The Claude Code and Codex plugins update themselves (README), so skills can change between sessions
  • The wizard skill writes scripts that put values into .env files or GitHub secrets, and handoff saves a summary of your chat in a temporary folder

Licence and author

Licence
MIT
Author
Matt Pocock
Source code
github.com/mattpocock/skills

How we tested it

We installed it on an empty test computer on 17 Oct 2026. Installed and started in a clean test system. Not yet used in a real AI session.

Test level

Not run: "codex plugin marketplace add mattpocock/skills" (not a form the sandbox runs). Not run: "codex plugin add mattpocock-skills@mattpocock" (not a form the sandbox runs). Not run: "gemini skills install https://github.com/mattpocock/skills.git --path skills/engineering" (not a form the sandbox runs). Not run: "gemini skills install https://github.com/mattpocock/skills.git --path skills/productivity" (not a form the sandbox runs). Not yet used on real work.

Technical details of the test
Date
17 Oct 2026
Method
Intake sandbox run on 2026-10-17 in a clean container with no account: cloned the repository and checked its skill, agent and plugin files; installed mattpocock-skills@claude-plugins-official with the Claude Code command line.

Checked again on 17 Oct 2026

Alternatives

  • Superpowers — a larger, stricter workflow that runs the whole process for you.
  • Planning with Files — keeps the plan in files so long tasks stay on track.
  • Addy Osmani agent skills — engineering habits for the whole build, from spec to launch.

FAQ

Is this for beginners? The author writes for engineers, but grill-me, to-spec and diagnosing-bugs help anyone who wants the assistant to ask and check before it acts.

Does it need an account or key? No for the skills. If you pick GitHub or GitLab as your tracker, the skills use your gh or glab sign-in.

Will it change my files? Yes. Skills such as tdd and implement write code, like any coding request, and the setup skill edits your project's instruction files. Read the changes before you keep them.

Which assistants work? The README gives install lines for Claude Code, Codex, Gemini CLI and Copilot, and npx skills for others. We tested only the Claude Code line.

Sources