
Codebase design
Shared vocabulary for designing deep modules
- Scripts
- None
- Platforms
- Claude Code, Codex, Cursor
- GitHub stars
- 326K
- Last commit
- today
- License
- MIT
- Listing updated
- today
When your agent uses it
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. Your agent reads this description to decide when to load the skill.
What it can access
From a static check of its 4 files (12 KB) on GitHub on 17 November 2026. Nothing was run. Read the files before you install a skill: it can tell your agent to run anything its tools allow.
Install
Copy the skill folder to ~/.claude/skills/codebase-design to use it in all your projects:
tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/mattpocock/skills.git "$tmp" &&
mkdir -p ~/.claude/skills &&
rm -rf ~/.claude/skills/codebase-design &&
cp -R "$tmp/skills/engineering/codebase-design" ~/.claude/skills/codebase-design &&
rm -rf "$tmp"For one project only, put the folder in .claude/skills/codebase-design inside it instead.
Copy the skill folder to ~/.agents/skills/codebase-design to use it in every repository:
tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/mattpocock/skills.git "$tmp" &&
mkdir -p ~/.agents/skills &&
rm -rf ~/.agents/skills/codebase-design &&
cp -R "$tmp/skills/engineering/codebase-design" ~/.agents/skills/codebase-design &&
rm -rf "$tmp"For one repository only, put the folder in .agents/skills/codebase-design inside it instead.
Copy the skill folder to ~/.cursor/skills/codebase-design to use it in every project:
tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/mattpocock/skills.git "$tmp" &&
mkdir -p ~/.cursor/skills &&
rm -rf ~/.cursor/skills/codebase-design &&
cp -R "$tmp/skills/engineering/codebase-design" ~/.cursor/skills/codebase-design &&
rm -rf "$tmp"For one project only, put the folder in .cursor/skills/codebase-design inside it instead.
Run in a terminal (add --scope workspace to install it for the current workspace only):
gemini skills install https://github.com/mattpocock/skills.git --path skills/engineering/codebase-designOr copy the folder to ~/.gemini/skills/codebase-design yourself.
For GitHub Copilot in VS Code, copy the skill folder to ~/.copilot/skills/codebase-design:
tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/mattpocock/skills.git "$tmp" &&
mkdir -p ~/.copilot/skills &&
rm -rf ~/.copilot/skills/codebase-design &&
cp -R "$tmp/skills/engineering/codebase-design" ~/.copilot/skills/codebase-design &&
rm -rf "$tmp"For one project only, put the folder in .github/skills/codebase-design inside it instead.
Get the folder:
git clone --depth 1 https://github.com/mattpocock/skills.gitThen copy skills/skills/engineering/codebase-design into your agent's skills folder as codebase-design. Agents that support SKILL.md read one folder per skill.
Codebase design FAQ
How do I install Codebase design in Claude Code?
Copy the skill folder from GitHub to ~/.claude/skills/codebase-design to use it in all your projects, or to .claude/skills/codebase-design in one project.
Does Codebase design run scripts?
No. It is instructions only, with no scripts. This comes from a static check of the files on GitHub; nothing was run. Read the files before you install it.
Which AI agents can use Codebase design?
Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, Windsurf and Goose. Each reads skills in the SKILL.md format from its own folder; the install steps on this page list them.
What are the best alternatives to Codebase design?
The closest alternatives to Codebase design are Rea tool design, Canvas design, Frontend design and Kiln.
More from mattpocock/skills


Review the changes since a fixed point (commit, branch, tag, or merge-base) along two axes: Standards (does the code follow this repo's docu
- Open source
- 326K GitHub stars
- Developer tools



A relentless interview to sharpen a plan or design, which also creates docs (ADR's and glossary) as we go.
- Open source
- 326K GitHub stars

Alternatives to Codebase design

Rea tool design
SkillAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.
- Open source
- 465K GitHub stars
- Design and media

Canvas design
SkillCreate beautiful visual art in .png and .pdf documents using design philosophy
- 196K GitHub stars
- Design and media

Frontend design
SkillGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one
- 196K GitHub stars
- Design and media

Kiln
SkillMakes and fixes 3D assets in Blender, for games, the web and AR
- Open source
- 221 GitHub stars
- Design and media



