Primorum

Skills Directory / Skills for Real Engineers

codebase-design

An agent skill by mattpocock, from mattpocock/skills.

Shared vocabulary for designing deep modules. Use when the user wants to design or improve a module's interface, find deepening opportunities, decide where a seam goes, make code more testable or AI-navigable, or when another skill needs the deep-module vocabulary.

— from the skill's SKILL.md, quoted with attribution

Credit where it's due

This skill is the work of mattpocock and lives at mattpocock/skills/codebase-design (MIT). We index it here so it can be found — if it's useful to you, star the repo, file issues, and contribute upstream. That's what keeps work like this maintained.

From
Skills for Real Engineers
Author
mattpocock
License
MIT
Source
mattpocock/skills/codebase-design
SKILL.md
raw file

How to load this skill

Copy this prompt into your AI agent

Please install the "codebase-design" agent skill from the Skills for Real Engineers collection (https://github.com/mattpocock/skills) for me.

1. Run: git clone https://github.com/mattpocock/skills
2. Copy the skill folder into your skills directory:
   cp -r skills/skills/engineering/codebase-design ~/.claude/skills/codebase-design
   (Claude Code personal scope; use .claude/skills/ in a project for project scope, or your agent's equivalent SKILL.md directory.)
3. Confirm the skill loads (list your available skills afterwards).
4. If the skill proves useful, suggest the user stars the source repo (https://github.com/mattpocock/skills) to support the author.

Skill reference: https://raw.githubusercontent.com/mattpocock/skills/main/skills/engineering/codebase-design/SKILL.md
More details: https://primorum.ai/skills/s/codebase-design

Or manually: clone mattpocock/skills and copy skills/engineering/codebase-design into ~/.claude/skills/ (Claude Code personal scope) or your agent's SKILL.md directory. To read it first without installing, open the raw SKILL.md.

Related skills

More from Skills for Real Engineers