Log inSign up
Skills › Coding & architecture
mattpocock logo
#7 by installsCoding & architecturemattpocock/skills

improve-codebase-architecture

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

Installs
1.2M
all time
This week
38.9K
installs
Repo stars
276.1K
GitHub
First seen
Mar 13, 2026
on skills.sh
Install
npx skills add https://github.com/mattpocock/skills --skill improve-codebase-architecture
Works with Claude Code, Cursor, Codex, GitHub Copilot, Windsurf, Gemini CLI and other agents that read SKILL.md.
What it does

Analyze codebases for architectural friction and propose module-deepening refactors as testability improvements. Scan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick.

  • Explores codebases organically to surface shallow modules, tightly-coupled components, and untested seams rather than following rigid heuristics
  • Applies John Ousterhout's "deep module" principle: small interfaces hiding large implementations for better testability and AI navigability
  • Generates multiple radically different interface designs (minimalist, flexible, caller-optimized, ports & adapters) via parallel sub-agents, then recommends the strongest approach
Source on GitHub ↗On skills.sh ↗