← Library

Agent skill

codebase-design

Matt Pocock

Gives the agent language for the thing most architecture conversations lack: where a seam belongs, what makes a module deep rather than wide, and why a narrow interface over real work is easier for both people and agents to navigate.

ArchitectureSystemsUpdated 3 months ago310,177 stars

In the author’s words

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.

The description field from SKILL.md, quoted as written.

Read it before you install it

SKILL.md · 109 lines

Install on its own

Or add it to your stack above and install everything at once.

npx skills add https://github.com/mattpocock/skills --skill codebase-design
Source ↗GitHub ↗skills.sh ↗Matt Pocock ↗

Trust audit

View the source ↗
100%verified
Resolved (HTTP 200), passed
Resolves · 310,177 stars, passed
Transcribed from the author's own page, passed
Last updated 3 months ago, passed
Credited to Matt Pocock, passed

All 5 checks passed when this was last run. Links were last checked on .

Goes well with

  • pick-ui-library

    Picks the library from the set Emil actually uses and trusts.

    Emil KowalskiSystemsComponents

    Stops your agent hand-rolling a toast or installing whatever is trending. Covers components, motion, charts, interaction, state and styling.

    npx skills add https://github.com/emilkowalski/skills --skill pick-ui-library

  • better-ui

    Concentric radius, optical alignment, surface depth, hit areas.

    Jakub KrehelCraftSystems

    Based on the Details That Make Interfaces Feel Better article. The small corrections that separate a shipped interface from a generated one.

    npx skills add https://github.com/jakubkrehel/skills --skill better-ui

  • ordinary-interfaces

    180 interface rules that each carry a number and its evidence grade.

    Finn MartenSystemsAccessibility

    Every rule states a value, cites whether that value is spec, measured or convention, and says where it stops applying. Reads your project's own tokens before it quotes a default, so a 7px radius in a 7px system is correct rather than a finding.

    npx skills add https://github.com/Board-ly/ordinary-interfaces

    SystemsAccessibilityReviewCraftFull page & trust audit →

Work with us