---
title: "Matt Pocock's skills"
description: "Matt Pocock's skills repo packages the agent skills he says he uses every day, built to be small, adaptable, and composable."
plain: "Matt Pocock's skills are small, adaptable agent skills he says he uses every day for real engineering."
group: idea
terms:
  - "Matt Pocock's skills"
  - "Matt Pocock"
  - "grill-with-docs"
  - "grilling session"
sources:
  - url: https://github.com/mattpocock/skills
    title: "GitHub - mattpocock/skills: Skills for Real Engineers. Straight from my .agents directory. · GitHub"
    publisher: "GitHub mattpocock/skills"
    note: "Skills repository; used for the public engineering and productivity skill collection."
    accessed: "2026-10-01"
  - url: https://github.com/mattpocock/skills/blob/d81f3a183412e71a5b1e84ca21bc1a35eea03a60/README.md
    title: "skills/README.md at d81f3a183412e71a5b1e84ca21bc1a35eea03a60 · mattpocock/skills · GitHub"
    publisher: "GitHub mattpocock/skills"
    note: "Pinned README; used for failure modes, composition, and installation choices."
    accessed: "2026-10-01"
---

# Matt Pocock's skills

> For agents: start with the [agent guide](https://ratstack.sh/llms.txt). Every page is Markdown by default; add `Accept: text/html` for HTML.

New on /news: [Foldkit 0.171.0 requires result Message schemas](/news).

[mattpocock/skills](https://github.com/mattpocock/skills) describes itself this way:

> "my agent skills that I use every day to do real engineering - not vibe coding."

The README says the skills are "designed to be small, easy to adapt, and composable," and work with any model. It invites you to hack around with them and make them your own. [README](https://github.com/mattpocock/skills/blob/d81f3a183412e71a5b1e84ca21bc1a35eea03a60/README.md)

The README organizes them around four failure modes. When an agent misses your intent, it prescribes a question-and-answer session to clarify intent: [`grill-me`](https://github.com/mattpocock/skills/blob/d81f3a183412e71a5b1e84ca21bc1a35eea03a60/skills/productivity/grill-me/SKILL.md) for non-code work and [`grill-with-docs`](https://github.com/mattpocock/skills/blob/d81f3a183412e71a5b1e84ca21bc1a35eea03a60/skills/engineering/grill-with-docs/SKILL.md).

`grill-with-docs` also builds a shared language in `GLOSSARY.md` and architecture decision records (ADRs).

For code that doesn't work it points to feedback loops, with [`tdd`](https://github.com/mattpocock/skills/blob/d81f3a183412e71a5b1e84ca21bc1a35eea03a60/skills/engineering/tdd/SKILL.md) and [`diagnosing-bugs`](https://github.com/mattpocock/skills/blob/d81f3a183412e71a5b1e84ca21bc1a35eea03a60/skills/engineering/diagnosing-bugs/SKILL.md). For code with tangled responsibilities it points to [`improve-codebase-architecture`](https://github.com/mattpocock/skills/blob/d81f3a183412e71a5b1e84ca21bc1a35eea03a60/skills/engineering/improve-codebase-architecture/SKILL.md).

The reference section splits the skills by whether the user or agent starts them. User-invoked skills run only when you type them. The agent can also select model-invoked skills automatically. It lists engineering and productivity groups, including `to-spec`, `to-tickets`, `implement`, `triage`, `handoff`, and `writing-for-agents`.

There are two ways to install. The Claude Code plugin installs the set as a managed, read-only bundle that updates when Matt ships. The `npx skills@latest add mattpocock/skills` installer copies editable files into your project. The README says to pick one.

Run `/setup-matt-pocock-skills` once per repo to set the issue tracker, triage labels, and doc locations.

Related: [Lauren Tan's skills](/lore/lauren-tan-skills).

## Sources

1. [GitHub - mattpocock/skills: Skills for Real Engineers. Straight from my .agents directory. · GitHub](https://github.com/mattpocock/skills)
   GitHub mattpocock/skills. Skills repository; used for the public engineering and productivity skill collection. Accessed 2026-10-01.

2. [skills/README.md at d81f3a183412e71a5b1e84ca21bc1a35eea03a60 · mattpocock/skills · GitHub](https://github.com/mattpocock/skills/blob/d81f3a183412e71a5b1e84ca21bc1a35eea03a60/README.md)
   GitHub mattpocock/skills. Pinned README; used for failure modes, composition, and installation choices. Accessed 2026-10-01.

## Linked from

- Agent guide → An Effect stack so pure (aspirational) Kit Langton will blush. → [Read page](https://ratstack.sh/llms.txt)

- Change log → What changed in the files served here, newest first. → [Read page](https://ratstack.sh/log)

- Dependency injection is the reason to choose Effect → Effect tracks service requirements in types and supplies replaceable implementations through Layers. → [Read page](https://ratstack.sh/lore/dependency-injection-is-the-reason-to-choose-effect)

- Full agent guide → An Effect stack so pure (aspirational) Kit Langton will blush. → [Read page](https://ratstack.sh/llms-full.txt)

- Lauren Tan's skills → Lauren Tan (poteto) publishes skills in several repos: brainmaxxing for memory and skill improvement, noodle for skill-based orchestration, how for explaining a codebase, and a verification-skill example. → [Read page](https://ratstack.sh/lore/lauren-tan-skills)

- Rat Stack lore | rat-stack → Short, source-grounded notes on the ideas and decisions behind rat-stack. → [Read page](https://ratstack.sh/lore)

- Source change history (log.md) → The generated change log as Markdown. → [Read page](https://ratstack.sh/log.md)
