🧭 Decision Guide
Why trending now: Cannot be determined from the provided material
Try it if you
-
You use Claude Code and want an automatically updated read-only skill bundle from its official marketplaceThe Installation section calls the Claude Code plugin a managed, read-only bundle in the official marketplace with automatic updates
-
You use Codex or another agent and want to copy skills into the project for local editingThe Installation section says npx skills writes skills into the repo as ordinary files you own and can edit
-
You need an agent to confirm module scope before specifications and strengthen feedback with /tddSections #3 and #4 of Why These Skills Exist introduce /tdd and /to-spec
-
You want /grill-with-docs to establish shared language and record decisions in ADRsSection #2 says /grill-with-docs builds a shared language and documents hard-to-explain decisions in ADRs
Skip it if you
-
You require a native Codex plugin rather than files installed through npx skillsThe Installation section explicitly says the native Codex plugin is on the roadmap
-
You must directly modify the managed Claude Code skill copyThe Installation section describes the Claude Code plugin as a managed, read-only bundle
-
You expect /improve-codebase-architecture to automatically clean up complexity in a mature codebaseSection #4 explicitly says it is a survey, not a rescue, and will not untangle the mud
-
You do not want installation to ask about the issue tracker, triage labels, and document locationStep 2 of Installation says /setup-matt-pocock-skills asks about all three settings
Requirements
- A Claude Code, Codex, or other coding-agent environment is required; the README does not list the full compatibility set
- Choose one installation path: the Claude Code plugin or npx skills@latest add mattpocock/skills
- With npx skills, the installer lets you choose skills and the coding agents to install them on
- Run /setup-matt-pocock-skills once per repo in the agent
First step (verbatim from README)
claude plugins install mattpocock-skills
Watch out
-
The installer must include setup-matt-pocock-skills, or the README's initialization flow cannot be followed as describedThe Codex and other agents section explicitly requires selecting setup-matt-pocock-skills
-
Run /setup-matt-pocock-skills once per repo and complete its three configuration questionsInstallation step 2 says to run it once per repo and lists three questions
-
skills.sh files do not update in the background; npx skills update is required for newer changesThe For tinkerers section says nothing updates behind your back and provides npx skills update
Alternatives
-
GSD:When you want one method to own the development process instead of composing editable skillsREADME comparison with GSD, BMAD, and Spec-Kit
-
BMAD:When you prefer a process solution such as BMAD to manage development as a unified workflowREADME comparison with GSD, BMAD, and Spec-Kit
-
Spec-Kit:When you want a process-owning solution such as Spec-Kit instead of composing skills yourselfREADME comparison with GSD, BMAD, and Spec-Kit
Not stated in the README
- The README does not specify supported versions for Claude Code, Codex, or other agents
- The full skill directory is not provided; the Reference, Engineering, and Productivity sections are omitted
- The README does not describe the input/output formats or failure behavior of /grill-me, /tdd, and /diagnosing-bugs
- The README does not give runtime version requirements for Shell or JavaScript
- The README provides no automated test results, performance figures, or security audit information
- The README does not specify the integration permissions required by GitHub, Linear, or local files
💡 Deep Analysis
7
No
I use Claude Code or Codex to maintain a complex legacy codebase and want the agent to scan it and directly perform large-scale architectural refactoring. Is this project suitable for automatically untangling that codebase?
No, not as an automatic refactoring engine, because the project provides architectural investigation and agent guidance rather than executing large-scale migrations for you.
- The project insight defines
improve-codebase-architectureas a recurring scan that identifies candidates for deeper modules and adjusted responsibilities. - The same insight states that it is an investigation tool and does not automatically untangle a complex legacy codebase.
- The README positions the skills as small, easy to adapt, and composable, while contrasting them with GSD, BMAD, and Spec-Kit approaches that own the whole process.
/diagnosing-bugsaddresses staged debugging; it is not an architectural migration or bulk-refactoring executor.
It is suitable if you want the agent to surface improvement candidates while engineers retain decisions. It is not suitable for unattended architectural rewrites.
- Project insight, solution_analysis.key_features: `improve-codebase-architecture` scans the codebase and identifies architectural candidates such as deeper modules and adjusted responsibilities
- Project insight, user_experience.usage_limitations: architecture review provides candidate improvement directions but cannot complete a systematic migration automatically
- README, “Skills For Real Engineers”: these skills are designed to be small, easy to adapt, and composable
- README, “Skills For Real Engineers”: GSD, BMAD, and Spec-Kit try to help by owning the process
npx skills@latest add mattpocock/skills
Yes
I maintain a real application and want Claude Code or Codex to clarify requirements first, create CONTEXT.md and ADRs, and then implement with red-green-refactor. Can this project cover that workflow?
Yes, because the README explicitly connects requirement grilling, shared language, ADRs, and /tdd as engineering practices rather than offering only code-generation prompts.
/grill-with-docsaligns the agent before implementation and helps create shared language and ADRs.- The README’s
CONTEXT.mdexample explains that consistent terminology improves variable, function, and file naming, while reducing the agent’s thinking-token use. /tddexplicitly encourages red-green-refactor: write a failing test first, fix the test with an implementation, and then refactor./diagnosing-bugspackages debugging into a gated, phase-by-phase loop, connecting post-implementation feedback back into the workflow.
It does not replace a test framework, type system, or browser environment; your project still has to provide those feedback sources.
- README, “#1: The Agent Didn't Do What I Want”: use `/grill-me` and `/grill-with-docs`; use them every time you want to make a change
- README, “#2: The Agent Is Way Too Verbose”: it helps build shared language with the AI and document hard-to-explain decisions in ADRs
- README, “#3: The Code Doesn't Work”: a red-green-refactor loop is critical; `/tdd` skill
- README, “#3: The Code Doesn't Work”: `/diagnosing-bugs` wraps best debugging practices into a disciplined loop
npx skills@latest add mattpocock/skills
Yes
For each repository, I want the initial skill setup to choose GitHub, Linear, or local files as the issue tracker, customize the labels used by `/triage`, and specify where documents are stored. Does this project support those repository-level constraints?
Yes, because the project provides a per-repository setup flow that asks for the issue tracker, labels, and document directory instead of hard-coding those choices.
- The README instructs you to run
/setup-matt-pocock-skillsonce per repo. - The setup asks you to choose GitHub, Linear, or local files as the issue tracker.
- It also asks which labels are used when triaging tickets and where created documents should be saved.
- In skills.sh mode, the skills are written into your repository as editable files, which fits project-owned configuration and version control; the Claude Code managed plugin is read-only.
This is a strong match for repository-level configuration and local ownership. However, the README does not detail the API permissions or automation depth for each tracker.
- README, “2. Run /setup-matt-pocock-skills”: in your agent, run it once per repo
- README, “2. Run /setup-matt-pocock-skills”: asks which issue tracker to use (GitHub, Linear, or local files)
- README, “2. Run /setup-matt-pocock-skills”: asks which labels you apply to tickets when you triage them
- README, “2. Run /setup-matt-pocock-skills”: asks where to save any docs created
/setup-matt-pocock-skills
Yes
I use Claude Code to build real applications. I want the complete skill set to update automatically when new versions ship, and I do not want editable copies inside my repository. Is this project suitable for me?
Yes, because the Claude Code plugin provides exactly the managed, read-only, automatically updated bundle you described.
- The Installation section says the plugin installs the whole set and receives updates when the author ships them.
- It is distributed through Claude Code’s official marketplace, so no additional marketplace setup is required.
- The skills are small, composable, and work with any model, so they guide agent behavior without taking ownership of the entire development process.
- You should not combine this mode with skills.sh: the README explicitly warns that installing both leaves every skill duplicated.
The trade-off is that the managed skills are not yours to edit. If your organization requires auditability or project-specific customization, the editable local-file mode is a better fit.
- README, “Installation (30-second setup)”: the Claude Code plugin installs the whole set as a managed, read-only bundle that updates when I ship
- README, “Installation (30-second setup)”: it is in Claude Code’s official marketplace
- README, “Skills For Real Engineers”: small, easy to adapt, and composable; they work with any model
- README, “Installation (30-second setup)”: installing both leaves you with every skill twice
claude plugins install mattpocock-skills
Yes
I use Claude Code, Codex, or another coding agent, but I do not want GSD, BMAD, or Spec-Kit to own the entire development process. I only want to combine `/grill-with-docs`, `/tdd`, and architecture-review skills. Does this project fit that constraint better?
Yes, because the project is explicitly positioned as a set of small, composable, editable skills between free-form prompting and heavyweight end-to-end frameworks.
- The README says the skills work with any model and are small, easy to adapt, and composable.
- The installer lets you choose which skills to take, so you can bring in only
/grill-with-docs,/tdd, or other selected capabilities. - The project explicitly contrasts itself with GSD, BMAD, and Spec-Kit approaches that own the process and take away user control; its stated invitation is to hack on the skills and make them your own.
- The skills.sh path copies them into the repository as ordinary files, allowing inspection, modification, and version control rather than requiring a closed bundle.
The trade-off is that selective composition leaves you responsible for deciding how the stages connect; the project does not own a complete process for you.
- README, “Skills For Real Engineers”: small, easy to adapt, and composable; they work with any model
- README, “Installation (30-second setup)”: the installer lets you choose which skills to take
- README, “Skills For Real Engineers”: GSD, BMAD, and Spec-Kit try to help by owning the process and take away your control
- README, “Installation (30-second setup)”: writes the skills into your repo as ordinary files you own and can edit
npx skills@latest add mattpocock/skills
It depends
I use Codex to build real applications and prefer an official native plugin instead of copied skill files in my repository. Does this project meet that installation constraint today?
It depends: Codex can use these skills through skills.sh, but the README explicitly says a native Codex plugin is still on the roadmap, so the current project cannot be confirmed to satisfy an “official native plugin” requirement.
- The README provides
npx skills@latest add mattpocock/skillsfor Codex and other agents. - The installer lets you choose both the skills and the coding agents that receive them, so you do not have to install the entire set.
- The copied-file mode writes ordinary files into your repository that you own and can edit; that conflicts with a requirement to avoid repository-local skill files.
- The README says to include
setup-matt-pocock-skillswhen selecting skills, otherwise the project configuration step is not completed as documented.
If local files are acceptable, the project is usable today. If a native plugin is mandatory, it does not meet that constraint yet.
- README, “Installation (30-second setup)”: Codex, and other agents; `npx skills@latest add mattpocock/skills`
- README, “Installation (30-second setup)”: a native Codex plugin is on the roadmap
- README, “Installation (30-second setup)”: it writes the skills into your repo as ordinary files you own and can edit
- README, “Installation (30-second setup)”: make sure `setup-matt-pocock-skills` is one of them
npx skills@latest add mattpocock/skills
It depends
I use Claude Code to build real applications, and the agent often misunderstands requirements, skips tests, and edits code directly. Can I use `/grill-me`, `/grill-with-docs`, and `/tdd` to build a feedback loop around these constraints?
It depends: these skills cover requirement alignment and testing feedback, but they guide the agent rather than guaranteeing that the agent will execute every stage correctly.
- The README identifies misalignment as a common failure mode and recommends
/grill-mefor non-code uses and/grill-with-docsfor engineering changes. /tddprovides red-green-refactor guidance, aiming to create a failing test first and then obtain implementation feedback.- The README also calls for real feedback sources, including static types, browser access, and automated tests; without them, the agent can still be flying blind.
- The project insight states that the skills are not a compiler, test framework, or code-quality platform, and cannot eliminate hallucinations or unreliable execution.
Thus, it fits as a workflow-guidance layer, not as an automatic correctness guarantee or quality gate.
- README, “#1: The Agent Didn't Do What I Want”: the most common failure mode is misalignment; use `/grill-me` and `/grill-with-docs`
- README, “#3: The Code Doesn't Work”: you need static types, browser access, and automated tests
- README, “#3: The Code Doesn't Work”: a red-green-refactor loop is critical
- Project insight, user_experience.usage_limitations: the project is agent behavior guidance and workflow assets, not a compiler, test framework, or code-quality platform
claude plugins install mattpocock-skills
✨ Highlights
-
248,424 stars, covering Claude Code, Codex, and other agents
-
/grill-with-docs combines questioning, shared language, and ADRs
-
/tdd provides a red-green-refactor testing loop
-
Installing the Claude Code plugin and skills.sh creates duplicate skills
🔧 Engineering
-
/setup-matt-pocock-skills configures GitHub, Linear, or local files
-
/to-spec asks which modules are affected before creating a spec
-
/diagnosing-bugs turns debugging into a phased process
-
The shared-language example standardizes the term materialization cascade
⚠️ Risks
-
The Claude Code plugin is a read-only managed bundle, so skill files cannot be edited directly
-
The README explicitly says using both installers leaves every skill twice
-
/improve-codebase-architecture is a survey and will not untangle an old codebase
-
The native Codex plugin is still on the roadmap; current installation uses npx skills
👥 For who?
-
Developers using Claude Code who want automatic updates from its official marketplace
-
Teams using Codex or other agents that want editable ordinary skill files
-
Engineering projects needing /tdd, /to-spec, and ADR workflows
-
Developers who want agents to learn project terminology and module boundaries