Skip to content
appsgit

Codebase Design

Codebase Design is an agent skill (a SKILL.md file) from mattpocock/skills. Shared vocabulary for designing deep modules. It works with Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot and OpenCode and has 303,491 GitHub stars across a repository of 15 listed skills.

github.com/mattpocock/skills/skills/engineering/codebase-design (opens in a new tab)

Data as of from the GitHub API and skills.sh; description from the skill's SKILL.md. Report an error

View on GitHub (opens in a new tab)View on skills.sh (opens in a new tab)

Add this skill

Claude

This repository is a Claude Code plugin marketplace. In Claude Code:

/plugin marketplace add mattpocock/skills
/plugin install mattpocock-skills@mattpocock

In the Claude apps, zip the codebase-design folder and upload it under Customize > Skills > + > Upload a skill (code execution must be on).

ChatGPT / Codex

Codex reads skills from .agents/skills/ in a repo or ~/.agents/skills/ for every project:

git clone --depth 1 https://github.com/mattpocock/skills.git
cp -r skills/skills/engineering/codebase-design .agents/skills/codebase-design   # repo; ~/.agents/skills for all projects

Standalone skills also load in the ChatGPT desktop app.

Cursor

Cursor loads skills from .cursor/skills/ (or ~/.cursor/skills/) and also reads .claude/skills/:

git clone --depth 1 https://github.com/mattpocock/skills.git
cp -r skills/skills/engineering/codebase-design .cursor/skills/codebase-design   # project; ~/.cursor/skills for all projects

Source (checked Oct 7, 2026): code.claude.com/docs/en/skills (opens in a new tab), code.claude.com/docs/en/plugin-marketplaces (opens in a new tab), support.claude.com/en/articles/12512180-using-skills-in-claude (opens in a new tab), learn.chatgpt.com/docs/build-skills (opens in a new tab), cursor.com/docs/context/skills (opens in a new tab)

What this skill does

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. Design deep modules: a lot of behaviour behind a small interface, placed at a clean seam, testable through that interface. Use this language and these principles wherever code is being designed or restructured.

When it triggers

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

More skills in mattpocock/skills

15 skills are listed from this repository.

Similar skills

More design & frontend skills

All Design & frontend

FAQ

Codebase Design FAQ

Still curious? Email info@appsgit.com.

How do I install the Codebase Design skill?

In Claude Code, run /plugin marketplace add mattpocock/skills and then /plugin install mattpocock-skills@mattpocock. For Codex or Cursor, copy the codebase-design folder into .agents/skills/ or .cursor/skills/.

Is the Codebase Design skill free?

Yes. The repository is open source under the MIT license.

Is Codebase Design maintained?

The repository's most recent commit was on Oct 19, 2026. Its latest release is v1.3.1. appsgit only lists skills from repositories with a commit in the last six months.