Matt PocockNames the things your codebase talks about and keeps those names honest, through a CONTEXT.md and architecture decision records. Worth reaching for when two parts of the system call the same concept different things.
In the author’s words
Build and sharpen a project's domain model. Use when discussing codebase terminology, writing or editing a CONTEXT.md, or recording or editing an ADR.
The description field from SKILL.md, quoted as written.
Read it before you install it
SKILL.md · 69 lines
Install on its own
Or add it to your stack above and install everything at once.
npx skills add https://github.com/mattpocock/skills --skill domain-modelingTrust audit
View the source ↗- Checked automatically and confirmed.
- Resolved (HTTP 200), passed
- Checked automatically and confirmed.
- Resolves · 309,686 stars, passed
- Checked automatically and confirmed.
- Transcribed from the author's own page, passed
- Checked automatically and confirmed.
- Last updated 3 months ago, passed
- Checked automatically and confirmed.
- Credited to Matt Pocock, passed
Goes well with
improve-codebase-architecture
Scans a codebase for deepening opportunities and reports them.
Walks the codebase looking for modules whose interface is wider than the work they do, writes the findings up as a visual report, then works through whichever one you pick. The useful part is that it argues each case rather than handing you a list.
npx skills add https://github.com/mattpocock/skills --skill improve-codebase-architecture
codebase-design
Shared vocabulary for designing deep modules.
Gives the agent language for the thing most architecture conversations lack: where a seam belongs, what makes a module deep rather than wide, and why a narrow interface over real work is easier for both people and agents to navigate.
npx skills add https://github.com/mattpocock/skills --skill codebase-design
to-spec
Turns the conversation you just had into a spec.
No interview and no questionnaire. It synthesises what has already been discussed into a spec and publishes it to the issue tracker, which is the step most people skip between deciding and building.
npx skills add https://github.com/mattpocock/skills --skill to-spec
PlanningFull page & trust audit →
Matt Pocock