What is codebase-design?
codebase-design is a Claude skill by mattpocock that 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. It is listed under Design & UI and has 761,600 installs.
| Type | Claude skill |
|---|---|
| Author | mattpocock |
| Repository | mattpocock/skills |
| Popularity | 761,600 installs |
| Category | Design & UI |
| Security | Low risk (100/100) |
| Rank | #19 of 1,262 Claude skills; #7 in Design & UI |
| SKILL.md length | 114 lines |
| License | MIT |
| Last commit | 2026-10-13 |
| Stars this week | +9,154 |
Is codebase-design safe to install?
codebase-design scores 100/100 on the MCPMods security check: Low risk. No checks raised a concern. It passed 9 of 9 checks.
Skill results come from a static scan of its SKILL.md for instruction overrides, hidden actions, risky commands and credential access.
| Check | Result |
|---|---|
| No instruction-override phrases | Pass |
| No hidden actions | Pass |
| No pipe-to-shell installers | Pass |
| No obfuscated code | Pass |
| No destructive commands | Pass |
| Doesn't ask for keys or credentials | Pass |
| No network requests | Pass |
| No shell commands | Pass |
| Installs no packages | Pass |
How do I install codebase-design?
- Install with the skills CLI. Works for Claude Code and other agents that read skills.
npx skills add https://github.com/mattpocock/skills --skill codebase-design
- Or copy it by hand. Claude Code loads any folder with a SKILL.md from ~/.claude/skills.
git clone https://github.com/mattpocock/skills cp -r skills/skills/engineering/codebase-design ~/.claude/skills/codebase-design
- Use it. Claude loads the skill when a task matches its description. You can also name it in your prompt.
Use the codebase-design skill to …
Or ask Claude to set it up
Paste this into Claude Code and it installs codebase-design for you:
Install the "codebase-design" skill from https://github.com/mattpocock/skills/tree/main/skills/engineering/codebase-design into ~/.claude/skills, then tell me in one line what it does.
More from mattpocock/skills
This repository has at least 9 Claude skills on MCPMods.
- grill-me: A relentless interview to sharpen a plan or design. (Low risk)
- grill-with-docs: A relentless interview to sharpen a plan or design, which also creates docs (ADR's and glossary) as we go. (Low risk)
- improve-codebase-architecture: Scan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you (Low risk)
- tdd: Test-driven development. Use when the user wants to build features or fix bugs test-first, mentions "red-green-refactor" (Low risk)
- setup-matt-pocock-skills: Configure this repo for the engineering skills: set up its issue tracker, triage label vocabulary, and domain doc layout (Low risk)
- handoff: Compact the current conversation into a handoff document for another agent to pick up. (Low risk)
- triage: Move issues and external PRs through a state machine of triage roles, categorise, verify, grill if needed, and write age (Low risk)
- prototype: Build a throwaway prototype to answer a design question. Use when the user wants to sanity-check whether a state model o (Low risk)