← 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 28 days ago263,533 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 · 263,533 stars, passed
Transcribed from the author's own page, passed
Last updated 28 days 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