CLI tool
mattpocock/skills avatar
mattpocock/skills

Matt Pocock's Skills: Small, Editable Agent Skills That Push Back on Vibe Coding

This repository collects Matt Pocock's reusable agent skills for TypeScript, testing, debugging, and day-to-day software work.

325,090 stars27,292 forksShellMIT

At a glance

What is it?
A look at mattpocock/skills, a collection of composable agent skills for TypeScript, testing, and debugging, and why its emphasis on grilling sessions and shared language might beat heavyweight process frameworks.
Who is it for?
Adopt this if you use Claude Code or Codex and want a lightweight, editable layer of process that forces alignment before coding. Skip it if you prefer a framework that owns the whole workflow, or if you are not willing to run a setup command per repo.
Can I use it commercially?
Yes. MIT is a permissive licence: you can use, modify and sell software built on it, as long as you keep its copyright and licence notices.
Is it still maintained?
Yes. The repository last received commits 2 days ago.
What is it written in?
Mainly Shell, according to GitHub's language statistics.

Answers come from the project's GitHub data, last synced on November 15, 2026, and from our analysis. They are not legal advice.

From daily snapshots

Star history

  • mattpocock/skills325,090 ★ · +132,435
Star history
Repository2026-07-282026-11-15
mattpocock/skills192.7k325.1k

132,435 Stars in the last 110 days, measured from the daily GitHub snapshot. Compare with other projects

Editorial analysis

What This Repo Actually Gives You

mattpocock/skills is a collection of agent skills built by Matt Pocock, aimed at TypeScript, testing, debugging, and everyday software work. The README positions these as an alternative to process-heavy approaches like GSD, BMAD, and Spec-Kit. Those frameworks, the argument goes, own the process and take away control, making bugs in the process hard to resolve. These skills are designed to be small, easy to adapt, and composable. They work with any model. The target user is a developer who uses coding agents like Claude Code or Codex and wants more control over how the agent behaves, not a team looking for a turnkey methodology.

The Core Mechanism: Grilling Sessions and Shared Language

The repo's central idea is that the most common failure mode is misalignment: you think the agent knows what you want, then it builds the wrong thing. The fix is a grilling session, a structured interrogation where the agent asks you detailed questions before writing code. Two skills implement this: /grill-me for non-code uses, and /grill-with-docs for engineering changes. The latter adds a shared language component. The README argues that agents dropped into a project use 20 words where 1 will do, and that a shared language document fixes this. The example given is the phrase 'materialization cascade' replacing a long explanation about lessons becoming 'real' in a file system. This shared language is documented in a glossary document and in ADRs. The claimed payoff is that variables, functions, and files get named consistently, the codebase becomes easier for the agent to navigate, and the agent spends fewer tokens on thinking. This is a concrete mechanism, not a vague promise, and it is the heart of the repo.

Installation: Two Philosophies, One Command

Installation takes about 30 seconds, according to the README. There is a plugin route for Claude Code, Codex, and GitHub Copilot, a manual route for Gemini CLI, and an npx route for any other agent or for editable files. For Claude Code, you run `claude plugin install mattpocock-skills@claude-plugins-official`, which updates itself by default. For Codex, you run `codex plugin marketplace add mattpocock/skills` and then `codex plugin add mattpocock-skills@mattpocock`, which updates itself at startup. For any other agent, or for editable files, you run `npx skills@latest add mattpocock/skills -a <agent>`, which copies editable skill files into your project, and you can choose which skills to take. The README warns to make sure `setup-matt-pocock-skills` is among them. The same command works for tinkerers on any agent, including Claude Code, and writes files you own and can edit. Updates are manual via `npx skills@latest update`. The README explicitly says to pick one method, because installing both leaves you with every skill twice. After installation, you run `/setup-matt-pocock-skills` once per repo. That command asks which issue tracker you use (GitHub, GitLab, local files, or anything else you describe), what labels you apply when triaging tickets, and where to save docs. This setup step is a real requirement, not optional.

The Feedback Loop Fix: More Than Just Alignment

Beyond alignment, the repo addresses the problem of code that still does not work. The README quotes The Pragmatic Programmer: 'Always take small, deliberate steps. The rate of feedback is your speed limit.' The argument is that without feedback on how the code actually runs, the agent is flying blind. It is the third failure mode the README lists, after misalignment and verbosity.

Limitations and Wrong Use Cases

The most obvious limitation is that this is a personal collection. The skills are built around Matt Pocock's workflow, and while the README encourages hacking on them, they may not fit your process without modification. The README itself says to 'hack around with them. Make them your own.' That is an admission that they are not universal. Another limitation is the dependency on a setup command per repo. If you forget to run `/setup-matt-pocock-skills`, the skills may not work correctly, because they depend on knowing your issue tracker and labels. Also, the skills are only as good as the model you use. The README says they work with any model, but the grilling session relies on the model asking good questions, which is not guaranteed. Finally, if you install both the plugin and the editable files, you get duplicates, which is a footgun the README warns about. This is not a tool for teams that want a standardized process across many developers; it is a tool for an individual who wants to shape their own agent's behavior.

Alternatives: Process Frameworks vs. Editable Skills

The README names GSD, BMAD, and Spec-Kit as alternatives that try to own the process. The key difference is control. Those frameworks provide a complete workflow, which can be helpful but also rigid. If a bug appears in the process itself, you have to debug the framework. mattpocock/skills takes the opposite approach: small, composable skills that you can edit and replace. The trade-off is that you get less guidance and more responsibility. With GSD, you might get a structured sequence of steps out of the box. With this repo, you get a set of prompts and instructions that you must adapt to your own context. The README now gives Codex its own plugin install route, with `codex plugin marketplace add mattpocock/skills`.

Maintenance and License Implications

The repo is under the MIT license, which means you can use, modify, and distribute the skills freely, as long as you preserve the copyright notice. This aligns with the tinkerer philosophy. Maintenance cost depends on which installation method you choose. The Claude Code plugin updates automatically when the author ships changes, so you get fixes and new skills without effort, but you also get changes you did not ask for, which could break your workflow. The editable files require manual updates via `npx skills@latest update`, which gives you control but also means you are responsible for tracking upstream changes. The repo has recent releases, with v1.3.2 published on 2026-10-29, so the project is actively maintained. The README mentions a newsletter with about 60,000 subscribers, which suggests a community, and the repo has a CONTRIBUTING.md.

Editorial conclusion

Adopt this if you use Claude Code or Codex and want a lightweight, editable layer of process that forces alignment before coding. Skip it if you prefer a framework that owns the whole workflow, or if you are not willing to run a setup command per repo. Before adopting, verify that the skills you need exist in the repo, check the latest release notes for changes, and decide whether you want the managed plugin or the editable files, because installing both duplicates every skill.

Frequently asked questions

How do you install mattpocock/skills in Claude Code?

Run `claude plugin install mattpocock-skills@claude-plugins-official`. The plugin sits in Claude Code's official marketplace, so there is nothing to add first, and updates arrive automatically.

How do you install mattpocock/skills in Codex?

Run `codex plugin marketplace add mattpocock/skills` and then `codex plugin add mattpocock-skills@mattpocock`; the plugin updates itself at startup.

How do you install mattpocock/skills from GitHub into Claude Code?

Use the same installer, `npx skills@latest add mattpocock/skills`, which works on any agent including Claude Code and writes the skills into your repo as ordinary files you own and can edit. Pull the author's later changes when you want them with `npx skills@latest update`.

How do you use the mattpocock/skills once they are installed?

Run `/setup-matt-pocock-skills` once per repo, then reach the skills as slash commands such as `/grill-me` for non-code work and `/grill-with-docs` for the same grilling session with a shared glossary and ADRs. The setup asks which issue tracker to use, which triage labels to apply, and where to save created docs.

Can you use mattpocock/skills in ChatGPT?

The installation instructions cover coding agents such as Claude Code, Codex, GitHub Copilot, and Gemini CLI, not ChatGPT.

Official sources

  1. Official README
  2. Project repository
  3. Release notes
Community

Where developers are discussing it

Posts on Hacker News, dev.to and Lobsters that link to this repository, found by our scan of those communities. 3 in the last 30 days; newest first.

Add this badge to your README

If you maintain this project, the badge below links readers to this analysis and shows its maintenance status from the daily GitHub snapshot. Paste the markdown into your README; add ?metric=license or ?metric=stars to the image URL for a different field.

Add this badge to your README

markdown
[![Hysen Labs](https://hysenlabs.com/badge/mattpocock-skills.svg)](https://hysenlabs.com/projects/mattpocock-skills)

Weekly Top 10 badge

markdown
[![Hysen Labs](https://hysenlabs.com/badge/mattpocock-skills.svg?metric=rank)](https://hysenlabs.com/projects/mattpocock-skills)

Star history chart for your README

markdown
[![Star history](https://hysenlabs.com/chart/mattpocock-skills.svg)](https://hysenlabs.com/projects/mattpocock-skills)
Community

Community discussions

Start a discussion about this project

Was this useful?