feat: introduce new skills and refine existing ones

- Add `ask-matt` skill for user-invoked routing.
- Introduce `codebase-design` and `domain-modeling` skills, updating dependencies.
- Remove unused `caveman` and `zoom-out` skills.
- Rename `diagnose` skill to `diagnosing-bugs`.
- Add `resolving-merge-conflicts` skill for handling git conflicts.
- Tighten `review` skill with improved checks.
- Update skill taxonomy to user-invoked and model-invoked.
- Replace `write-a-skill` with `writing-great-skills` for better guidance.
This commit is contained in:
Matt Pocock 2026-06-17 15:39:06 +01:00
commit 47bde84da0
9 changed files with 63 additions and 12 deletions

7
.changeset/ask-matt.md Normal file
View file

@ -0,0 +1,7 @@
---
"mattpocock-skills": major
---
Add the **`ask-matt`** skill — a user-invoked router that points you at the right skill or flow for your situation.
**Breaking:** `ask-matt` routes over the other user-invoked skills in this repo, so it expects them to be installed.

View file

@ -0,0 +1,13 @@
---
"mattpocock-skills": major
---
Add the shared design skills and rewire existing skills onto them.
- New **`codebase-design`** skill — the deep-module vocabulary (module, interface, depth, seam, adapter) and the principles for putting a lot of behaviour behind a small interface. The language that previously lived in `improve-codebase-architecture/LANGUAGE.md` now lives here, generalized for reuse across skills.
- New **`domain-modeling`** skill — actively build and sharpen a project's domain model, stress-testing terms against the glossary and keeping `CONTEXT.md` and ADRs current.
- `improve-codebase-architecture` now draws its architecture vocabulary from `/codebase-design` and its domain model from `/domain-modeling`.
- `tdd` now leans on `/codebase-design` for interface-design guidance — its inline `deep-modules.md` / `interface-design.md` notes were removed in favour of the shared skill.
- `grill-with-docs` now builds the domain model inline via `/domain-modeling`.
**Breaking:** these skills now depend on the new `codebase-design` / `domain-modeling` skills, so you must install them too.

View file

@ -1,12 +0,0 @@
---
"mattpocock-skills": minor
---
Recent skill updates:
- Add `ask-matt` user-invoked skill for triage and multi-session build guidance.
- Add `writing-great-skills` skill, with no-op hunting at the sentence level.
- Add `decision-mapping`, `prefactoring`, and `implement` (PRD-based) skills.
- Tighten the review skill: fail-fast ref check, single-sourced rules, no-op cuts.
- Rename terminology from Commands/Skills to User-invoked/Model-invoked across the docs.
- Remove the `caveman` and `zoom-out` skills and all references.

View file

@ -0,0 +1,10 @@
---
"mattpocock-skills": major
---
Remove the **`caveman`** and **`zoom-out`** skills.
- `caveman` was a duplicate of another skill I was testing and was never meant to be public.
- `zoom-out` went unused in practice, so it's been removed from the repo.
**Breaking:** both skills have been removed.

View file

@ -0,0 +1,7 @@
---
"mattpocock-skills": major
---
Rename the **`diagnose`** skill to **`diagnosing-bugs`**.
**Breaking:** invoke it as `/diagnosing-bugs` — the old `/diagnose` name no longer exists.

View file

@ -0,0 +1,5 @@
---
"mattpocock-skills": minor
---
Add the **`resolving-merge-conflicts`** skill — a loop for resolving an in-progress git merge or rebase conflict. Standalone, with no dependencies on other skills.

View file

@ -0,0 +1,5 @@
---
"mattpocock-skills": patch
---
Tighten the **`review`** skill: fail-fast ref check, single-sourced rules, and no-op cuts.

View file

@ -0,0 +1,5 @@
---
"mattpocock-skills": minor
---
Rename the skill taxonomy from **Commands / Skills** to **User-invoked / Model-invoked** across the docs, and add `docs/invocation.md` defining the split: user-invoked skills are reachable only when you type them and exist to orchestrate; model-invoked skills can also be reached automatically when the task fits. A user-invoked skill may invoke model-invoked skills, but never another user-invoked one.

View file

@ -0,0 +1,11 @@
---
"mattpocock-skills": major
---
Replace **`write-a-skill`** with **`writing-great-skills`**.
- Removed `write-a-skill`.
- Added `writing-great-skills` (plus its `GLOSSARY.md`) — a reference for writing and editing skills well: the vocabulary and principles that make a skill predictable, hunting no-ops down to the sentence level.
- Exposed `grilling` as a model-invoked skill — the reusable interview loop behind `grill-me` and `grill-with-docs`.
**Breaking:** `write-a-skill` has been removed; use `writing-great-skills` instead.