Claude Skills
SkillsResultsReplayCollectionsGuidesNominate
© 2026 Curated Agent SkillsBrowse skillsHistorical indexAbout this guide·Learn more about Agent Skills
← All curated skills

Architecture · Matt Pocock

Codebase Design by Matt Pocock

Designs deep modules with small interfaces, clean seams, and testable behavior.

View original skill instructionsMatt Pocock Skills

Setup and compatibility

Part of Matt Pocock Skills. The 25 promoted skills remain strongest as a Claude Code-centered personal workflow, although editable copies work across agents. The most ambitious orchestration and self-improvement ideas are still under in-progress, rely on background agents, worktrees, issue graphs, and project conventions, and should not yet be treated as stable lifecycle coverage.

Editorial compatibility guidance: Claude Code · Codex. This is not an executed compatibility test; see the review for source and run evidence.

Read Codebase Design instructions and prerequisites · Read Matt Pocock Skills setup documentation

Independent review

Codebase Design gives agents a compact architectural vocabulary centered on deep modules, narrow interfaces, locality, and testable seams. It improves design conversations without pretending that a generic architecture pattern fits every repository.

Read the Codebase Design review and usage guide

Try this skill

InstallGet starter request

Install · Selected skill + setup skill

Run in a terminal from your target project. Requires Node.js 22.20+, npm/npx, Git and network access.

Also installs setup-matt-pocock-skills; run that setup skill once per repository.

npx skills@latest add mattpocock/skills --skill codebase-design --skill setup-matt-pocock-skills -a claude-code

Command / route checked 30 October 2026. Upstream installationCLI optionsAgent support

Setup requirements and caveats

Run in a terminal from the target project. Requires Node.js 22.20+ (current skills CLI), npm/npx, Git and network access. Review the installer summary before confirming. Keeps this skill’s supporting files. Also installs setup-matt-pocock-skills; run that setup skill once per repository. Avoid installing both plugin and file copies. Grill Me may load its grilling dependency from upstream.

These are documented requirements; installation has not been tested here.

Your agent needs its own account, runtime and model access. Usage charges depend on your plan; unrecorded costs are unknown.

Run the example

Start a fresh session in the target project. Provide the relevant files or diff. This is the review’s example request, not a record of your execution.

Use the codebase-design skill. Design a single pricing module that hides provider rules and exposes the smallest interface needed by checkout, invoices, and previews.

Check your result · Successful first run

A proposed deep module with a small interface, justified against its callers.

Confirm the agent loaded the named skill, inspect the output and run the relevant checks. Installation alone does not prove a successful run.

Something not working?

The skill is missing from my agent

Check that the skill is installed for the selected agent and project/global scope. Open a fresh session in that project and check the agent’s skill list. Plugin installs may also need to be enabled.

The wrong skill runs, or nothing happens

Start a fresh conversation, explicitly name the skill using the request above, and provide the requested inputs. Ask the agent to confirm which skill it loaded. Check for duplicate installed copies or overlapping instructions.

The skill runs but the result is poor

Compare the result with the successful-first-run check above. Supply the missing files, reproduction steps or constraints, then ask for one focused correction. If the skill addresses a different problem, return to the task guide and compare alternatives.

Installation troubleshooting · missing dependencies

If npx fails, check the Node/npm versions in setup requirements, Git and network access. For skills CLI installs, run npx skills list (add -g for global). If a route changed, follow upstream instructions.

Collection background and tradeoffs

The 25 promoted skills remain strongest as a Claude Code-centered personal workflow, although editable copies work across agents. The most ambitious orchestration and self-improvement ideas are still under in-progress, rely on background agents, worktrees, issue graphs, and project conventions, and should not yet be treated as stable lifecycle coverage.

Source maintained by Matt Pocock. Read original skill. Compatibility guidance and published showcase runs remain separate from your first run.

Related workflows

  • Code Review
  • Codebase Architecture