mattpocock/skills

improve-codebase-architecture

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

All-time #5 Trending #64 First seen Mar 13, 2026
8-week activity · all time api

Installation

$ npx skills add https://github.com/mattpocock/skills
Feature your product here Skill page unit · reach builders installing agent skills View pricing →

Summary

  • Analyze codebases for architectural friction and propose module-deepening refactors as testability improvements.
  • 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 Creates GitHub issue RFCs documenting the problem space, design trade-offs, and refactoring rationale

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

Security audits

Partner security reviews for this skill.

agent-trust-hub Reviewed

Analyzed Sep 29, 2026

snyk Reviewed

Analyzed Sep 29, 2026

socket Score 0.9000 · 0 alerts

Analyzed Sep 29, 2026

  • license 1
  • maintenance 1
  • quality 0.9
  • supply chain 1
  • vulnerability 1

0 alerts

Also in this package

Other skills from mattpocock/skills · top by installs.

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

Browse all from mattpocock/skills

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 256.9K
License MIT
Default branch main
Open issues 484
Last push Sep 4, 2026
Status Active

History

  1. First seen on skills.sh
  2. SKILL.md last updated on GitHub
  3. First recorded snapshot · 895,700 installs