Skip to content
Kitbay
Skill

improve-codebase-architecture

MITUpdated on Nov 9, 2026321,493GitHub stars

A skill from Matt Pocock's collection, started only by the user, that looks for shallow modules in a codebase that could be merged into deeper ones.

What the skill teaches

A skill from Matt Pocock's collection, started only by the user, that looks for shallow modules in a codebase that could be merged into deeper ones. It starts from a direction the user gives or from areas with many recent git commits, reads the glossary and architecture decision records, and sends a subagent to look for friction. Candidates go into a self-contained HTML report saved to the temp folder and opened in the browser, each with the files involved, the problem, a proposed change and before and after diagrams. The user picks one, and the agent works through its design in a question-led discussion, updating the glossary and offering to record decisions.

Capabilities

  • Find shallow modules worth merging
  • Write an HTML report of refactoring candidates
  • Draw before and after diagrams for each candidate
  • Update a glossary and record design decisions