Agent skill pack · 39 skills
Skills for Real Engineers
Skills for Real Engineers is Matt Pocock's set of small, composable agent skills that make coding agents interview you before building, write tests first, debug in gated steps and keep modules deep and simple. It is aimed at developers doing production work, and installs on Claude Code, Codex, GitHub Copilot, Gemini CLI, Cursor and other agents.
Works with
- Claude Code
- Codex
- GitHub Copilot
- Gemini CLI
- Cursor, OpenCode, Windsurf, Amp and others
What problems it solves
- The agent builds something other than what you meantGrilling skills have the agent question you about every open decision before any code is written, so the plan is agreed rather than guessed.
- The agent uses twenty words where one would doA project glossary built during design sessions gives the agent and you the same short names for the same concepts.
- The code looks right but does not workA test-first loop and a gated debugging routine give the agent real pass/fail feedback at every step.
- Agent-written code turns into a tangleDesign, architecture and review skills push toward deep modules with small interfaces and check each change against the repo's own standards.
The core workflow
These skills are built to be used one after another.
- 1
/grill-with-docsInterviews you about a plan and records agreed terms and decisions as glossary and ADRs. - 2
/to-specTurns what you already discussed into a spec on your issue tracker. - 3
/to-ticketsSplits a plan or spec into small tickets that state what blocks what. - 4
/implementBuilds a piece of work from a spec or tickets, test-first, then reviews it. - 5
/code-reviewReviews changes since a commit or branch against repo standards and the original spec.
Skill guides
Explained step by step on this site
/diagnosing-bugsA gated debugging loop for hard bugsWorks through hard bugs and slowdowns in gated steps, starting from a reproducible failure.Read the guide →/grill-with-docsPlan interviews that build a project glossaryInterviews you about a plan and records agreed terms and decisions as glossary and ADRs.Read the guide →/tddTest-driven development for coding agentsBuilds features or fixes bugs test-first, one failing test and one fix at a time.Read the guide →
All 39 skills
Skill names are shown as /name: depending on your agent, a skill runs when it is relevant or when you call it by name, and plugin installs may add a prefix. Highlighted skills have a guide on this site; the others open their folder on GitHub.
Engineering 20
/ask-mattSuggests which skill or workflow in the pack fits your current situation.↗/code-reviewReviews changes since a commit or branch against repo standards and the original spec.↗/codebase-designProvides shared terms for designing deep modules with small, testable interfaces.↗/diagnosing-bugsWorks through hard bugs and slowdowns in gated steps, starting from a reproducible failure.→/domain-modelingBuilds and maintains the project's glossary and architecture decision records during design talks.↗/grill-with-docsInterviews you about a plan and records agreed terms and decisions as glossary and ADRs.→/implement-specImplements a whole spec on one branch, running subagents across ready tickets.↗/implementBuilds a piece of work from a spec or tickets, test-first, then reviews it.↗/improve-codebase-architectureScans the codebase for simplification opportunities and presents them as a visual HTML report.↗/prWrites a pull request body with a summary, evidence it works and merge risk.↗/prototypeBuilds a throwaway prototype to answer one design or UI question quickly.↗/researchAnswers a question from primary sources and saves cited findings as Markdown in the repo.↗/retroReviews a finished coding session and suggests improvements to the agent's environment.↗/setup-matt-pocock-skillsConfigures a repo once with its issue tracker, triage labels and doc locations.↗/tddBuilds features or fixes bugs test-first, one failing test and one fix at a time.→/to-specTurns what you already discussed into a spec on your issue tracker.↗/to-ticketsSplits a plan or spec into small tickets that state what blocks what.↗/triageMoves issues and outside PRs through triage states and writes agent-ready briefs.↗/wayfinderPlans work too large for one session as a map of decision tickets.↗/wizardGenerates an interactive terminal wizard that guides a human through steps only they can do.↗
Setup and migrations 4
/git-guardrails-claude-codeAdds Claude Code hooks that block risky git commands like push or reset --hard.↗/migrate-to-shoehornReplaces as type assertions in test files with the shoehorn library.↗/scaffold-exercisesCreates course exercise folders with problems, solutions and explainers that pass linting.↗/setup-pre-commitSets up Husky pre-commit hooks running formatting, type checks and tests.↗
Productivity 7
/grill-meInterviews you hard about any plan or idea, including non-code ones.↗/grillingRuns the round-by-round questioning routine that the other grill skills build on.↗/handoffCompresses the current conversation into a note another agent can continue from.↗/teachTeaches you a new concept over several sessions using the workspace as memory.↗/to-questionnaireTurns a decision you cannot make alone into a questionnaire for someone else.↗/wait-whatMakes the agent re-explain its last message in plain language with missing context.↗/writing-for-agentsGuides writing skills, AGENTS.md, CLAUDE.md and other documents agents read.↗
In progress 8experimental
/chief-of-staffPursues a long-running goal within one session by coordinating subagents.↗/claude-handoffHands the current conversation to a fresh background agent that continues the work.↗/loop-meInterviews you about the specs of workflows you want to build in the workspace.↗/setup-ts-deep-modulesWires dependency-cruiser into a TypeScript repo to enforce deep-module package boundaries.↗/software-factoryGives shared terms for designing an automated software factory and its services.↗/writing-beatsArranges raw writing material into a sequence of beats, defining terms before use.↗/writing-fragmentsCollects raw writing fragments before any structure is imposed.↗/writing-shapeShapes raw material into an article, working paragraph by paragraph.↗
No skill matches that filter.
Install
Pick your agent; commands come from the author’s README.
Claude CodeInstalled as a plugin that updates itself by default.
claude plugin install mattpocock-skills@claude-plugins-officialCodexUpdates at startup.
codex plugin marketplace add mattpocock/skills
codex plugin add mattpocock-skills@mattpocockGitHub CopilotWorks in the CLI and VS Code; the README also shows a one-time settings.json entry to enable auto-update.
copilot plugin marketplace add mattpocock/skills
copilot plugin install mattpocock-skills@mattpocockGemini CLIRe-run both commands to update.
gemini skills install https://github.com/mattpocock/skills.git --path skills/engineering
gemini skills install https://github.com/mattpocock/skills.git --path skills/productivityCursor, OpenCode, Windsurf, Amp and othersCopies editable files into your project; update with npx skills@latest update. Use either this or a plugin per agent, not both.
npx skills@latest add mattpocock/skills -a <agent>After installing, run /setup-matt-pocock-skills once per repository; it asks which issue tracker you use, which triage labels you apply and where generated docs should live. Check the author’s README for changes before you run a command.
Questions
Is Skills for Real Engineers free to use?
Yes. The repository is published under the MIT license, so you can use, change and share the skills, including in commercial work.
Which agents does the pack support?
The README gives install commands for Claude Code, Codex, GitHub Copilot and Gemini CLI, plus an npx installer for Cursor, OpenCode, Devin, Windsurf, Amp, Pi and other agents.
How do I keep the skills up to date?
Plugin installs on Claude Code, Codex and Copilot update themselves. Gemini CLI installs are updated by re-running the install commands, and npx installs with npx skills@latest update.
This page is trendhub’s own summary of a public repository. The skills, their text and every update live in mattpocock/skills by Matt Pocock; we do not host or modify the files.