# Skills

Personal Claude Code skills, organized into bucket folders under `skills/`. See [CLAUDE.md](./CLAUDE.md) for the rules that keep this index in sync with the skill folders and for the User-invoked vs Model-invoked split.

## Engineering

Skills I use daily for code work.

**User-invoked**

- **[ask-matt](./skills/engineering/ask-matt/SKILL.md)** — Ask which skill or flow fits your situation. A router over the user-invoked skills in this repo.
- **[grill-with-docs](./skills/engineering/grill-with-docs/SKILL.md)** — Grilling session that also builds your project's domain model, sharpening terminology and updating `CONTEXT.md` and ADRs inline.
- **[triage](./skills/engineering/triage/SKILL.md)** — Move issues through a state machine of triage roles.
- **[improve-codebase-architecture](./skills/engineering/improve-codebase-architecture/SKILL.md)** — Scan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick.
- **[setup-matt-pocock-skills](./skills/engineering/setup-matt-pocock-skills/SKILL.md)** — Configure this repo for the engineering skills (issue tracker, triage labels, domain doc layout). Run once per repo.
- **[to-issues](./skills/engineering/to-issues/SKILL.md)** — Break any plan, spec, or PRD into independently-grabbable issues using vertical slices.
- **[to-prd](./skills/engineering/to-prd/SKILL.md)** — Turn the current conversation into a PRD and publish it to the issue tracker.
- **[prototype](./skills/engineering/prototype/SKILL.md)** — Build a throwaway prototype — a runnable terminal app for state/logic questions, or several toggleable UI variations.
- **[implement](./skills/engineering/implement/SKILL.md)** — Implement work from a PRD or set of issues: TDD at pre-agreed seams, typecheck and test as you go, then review and commit.

**Model-invoked**

- **[diagnosing-bugs](./skills/engineering/diagnosing-bugs/SKILL.md)** — Disciplined diagnosis loop for hard bugs and performance regressions: reproduce → minimise → hypothesise → instrument → fix → regression-test.
- **[tdd](./skills/engineering/tdd/SKILL.md)** — Test-driven development with a red-green-refactor loop. Builds features or fixes bugs one vertical slice at a time.
- **[domain-modeling](./skills/engineering/domain-modeling/SKILL.md)** — Actively build and sharpen a project's domain model — challenge terms, stress-test with scenarios, update `CONTEXT.md` and ADRs inline.
- **[codebase-design](./skills/engineering/codebase-design/SKILL.md)** — Shared discipline and vocabulary for designing deep modules: small interfaces, clean seams, testable through the interface.
- **[resolving-merge-conflicts](./skills/engineering/resolving-merge-conflicts/SKILL.md)** — Work an in-progress git merge/rebase conflict hunk by hunk, resolving by intent, and always finish it (never `--abort`).
- **[frontend-design](./skills/engineering/frontend-design/SKILL.md)** — Build distinctive, production-grade frontend UI that avoids generic "AI slop" aesthetics.

## Productivity

Daily non-code workflow tools.

**User-invoked**

- **[grill-me](./skills/productivity/grill-me/SKILL.md)** — Relentless interview to sharpen a plan or design, for non-code uses.
- **[handoff](./skills/productivity/handoff/SKILL.md)** — Compact the current conversation into a handoff document so another agent can continue the work.

**Model-invoked**

- **[grilling](./skills/productivity/grilling/SKILL.md)** — Interview the user relentlessly about a plan or design until every branch of the decision tree is resolved. The reusable loop behind `grill-me`.

## Misc

Tools I keep around but rarely use.

**Model-invoked**

- **[codex-debugging](./skills/misc/codex-debugging/SKILL.md)** — Investigate Codex CLI/app-server behavior, config parsing, tool behavior, prompts, and MCP wiring bugs.
- **[git-guardrails-claude-code](./skills/misc/git-guardrails-claude-code/SKILL.md)** — Set up Claude Code hooks to block dangerous git commands (push, reset --hard, clean, branch -D, etc.) before they execute.
- **[github-deep-review](./skills/misc/github-deep-review/SKILL.md)** — Evidence-first review of a bug or PR: read the code, find the real cause, decide the best fix, and say "not proven" when the trail is weak.
- **[github-project-triage](./skills/misc/github-project-triage/SKILL.md)** — Triage a GitHub project's issues/PRs into maintainer-facing item cards: what it's about, risk, proof/test state, blockers, next action.