Skip to content
Skill

Codebase design

Shared vocabulary for designing deep modules

Install
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.

Claude Code docs on skills

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.

Codex docs on skills

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.

Cursor docs on skills

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-design

Or copy the folder to ~/.gemini/skills/codebase-design yourself.

Gemini CLI docs on skills

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.

VS Code docs on skills

Get the folder:

git clone --depth 1 https://github.com/mattpocock/skills.git

Then 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.

The SKILL.md format

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

  1. Ask which skill or flow fits your situation

    • Open source
    • 326K GitHub stars
  2. 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
  3. Diagnosis loop for hard bugs and performance regressions

    • Open source
    • 326K GitHub stars
  4. Build and sharpen a project's domain model

    • Open source
    • 326K GitHub stars
  5. 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
  6. Implement a piece of work based on a spec or set of tickets.

    • Open source
    • 326K GitHub stars

Alternatives to Codebase design

  1. Audit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.

    • Open source
    • 465K GitHub stars
    • Design and media
  2. Create beautiful visual art in .png and .pdf documents using design philosophy

    • 196K GitHub stars
    • Design and media
  3. Guidance for distinctive, intentional visual design when building new UI or reshaping an existing one

    • 196K GitHub stars
    • Design and media
  4. Kiln

    Skill

    Makes and fixes 3D assets in Blender, for games, the web and AR

    • Open source
    • 221 GitHub stars
    • Design and media