mattpocock/skills

improve-codebase-architecture

All-time #4 Trending #25 Hot #6812 First seen Mar 13, 2026
8-week activity · all time api

Installation

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

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 SAFE

Analyzed May 20, 2026

The skill is a specialized architectural analysis assistant designed to help developers refactor shallow modules into deep ones. It focuses on codebase exploration and documentation management (ADRs and domain glossaries) without any detected malicious patterns or security risks.

snyk LOW

Analyzed May 20, 2026

No issues detected.

socket Score 0.9000 · 0 alerts

Analyzed May 20, 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