Improve codebase architecture
Finds the places where deepening a module would remove a whole class of call-site complexity.
Installation
$ npx skills add mattpocock/skillsThe CLI's unit is the repository, so this installs everything in mattpocock/skills, not improve-codebase-architecture alone. It writes into whichever agent directories it finds — Claude Code, Codex, Cursor, Copilot, Windsurf, Zed.
Summary
Finds the places where deepening a module would remove a whole class of call-site complexity.
- Reach for it when every feature touches nine files and you want to know which boundary is wrong.
- Spans Design & architect and Review, so it is usually worth loading for the whole piece of work rather than at one moment in it.
- Stack-agnostic — nothing in it assumes a particular language or framework.
- Published by Matt Pocock. Well regarded, but not the vendor of the thing it covers.
- Installing pulls the whole mattpocock/skills repository: this catalogue lists 6 other entries from it, and the repo may hold more.
Where it sits in delivery
Design & architectInterfaces, module boundaries and domain language — decided before the code sets them in concrete.Everything in Design →
ReviewReading a diff critically, and the far harder skill of acting on what a reviewer said.Everything in Review →
The skill itself
The full text lives with its publisher and changes when they change it. Read it there rather than here — a mirrored copy of somebody else's procedure goes stale silently, and this page would have no way of telling you.
Related
More in Design & architect
- Frontend designAnthropic's guidance for producing interfaces that look designed rather than defaulted.
anthropics/skills - Web design guidelinesVercel's design rules for agent-generated web interfaces: layout, spacing, typography, motion, state.
vercel-labs/agent-skills - API & interface designDesigning interfaces that are hard to misuse and cheap to evolve — naming, versioning, error shape, defaults.
addyosmani/agent-skills - Code review & qualityWhat to look for in a diff, in priority order, and what to leave alone.
addyosmani/agent-skills - Code simplificationReduces complexity while preserving exact behaviour — judged on whether a new joiner reads it faster, not on line count.
addyosmani/agent-skills - Deprecation & migrationRetiring an old path safely: migrating consumers, proving nothing still calls it, then deleting it.
addyosmani/agent-skills