← Library

Agent skill

improve-codebase-architecture

Matt Pocock

Walks the codebase looking for modules whose interface is wider than the work they do, writes the findings up as a visual report, then works through whichever one you pick. The useful part is that it argues each case rather than handing you a list.

ArchitectureReviewUpdated 28 days ago263,541 stars

In the author’s words

Scan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick.

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

Read it before you install it

SKILL.md · 65 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 improve-codebase-architecture
Source ↗GitHub ↗skills.sh ↗Matt Pocock

Trust audit

View the source ↗
100%verified
Resolved (HTTP 200), passed
Resolves · 263,541 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

  • emil-design-eng

    The design-engineering house style behind Sonner and Vaul.

    Emil KowalskiMotionCraft

    Emil's main skill. Mostly animation, with the UI-polish and component judgement that surrounds it: what to build, how far to push it, and when to stop.

    npx skills add https://github.com/emilkowalski/skills

  • review-animations

    Reviews your motion strictly, against Emil's rules.

    Emil KowalskiMotionReview

    A production-critical pass over animation quality, timing and consistency in a diff. Pairs with improve-animations, which does the same for a whole codebase.

    npx skills add https://github.com/emilkowalski/skills --skill review-animations

  • improve-animations

    Audits every animation in a codebase and hands back prioritised plans.

    Emil KowalskiMotionReview

    Read-only on source. Surveys the motion you already ship and produces self-contained implementation plans any agent can execute, ordered by what actually matters.

    npx skills add https://github.com/emilkowalski/skills --skill improve-animations

Work with us