improve-codebase-architecture
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
About
- Publisher
- Matt Pocock
- Tool
- Code review
Install
The project doesn't document install steps that we could confirm. See the project's own instructions
What's inside
- HTML-REPORT.md
- agents/openai.yaml
MCP servers and skills can run code on your computer and act on your data. Review the source before installing.
Details
| Fact | Value | Source |
|---|---|---|
| Type | Skill | |
| Tool | Code review | |
| Publisher | Matt Pocock | source |
| Official status | Not stated in its documentation | |
| Needs an API key or sign-in | Not stated in its documentation | |
| Includes scripts | No | source |
| Platforms | Not stated in its documentation | |
| AI clients | Not stated in its documentation | |
| Licence | MIT | source |
| Pricing | Not stated in its documentation | |
| Activity | Last commit Nov 9, 2026321,493 GitHub starsDownload data not available (not on npm or PyPI) | source |
| Links | Repository Website |
Copies of this skill in other repositories (14)
These differ from this skill's text. They may be adapted copies or older versions.
- improve-codebase-architecturewindmill-labs/windmill
- improve-codebase-architecturetiberriver256/mcp-server-azure-devops
- improve-codebase-architecturepc-style/x-md
- improve-codebase-architecturerengwu/wayfinder-maps
- improve-codebase-architectureethanyoq/skill-hub
- improve-codebase-architecturemhrsdev/ai-agent-skills-library
- improve-codebase-architecturemhrsdev/ai-agent-skills-library
- improve-codebase-architectureleek/agent-skills
- improve-codebase-architecturevalorvie/custom-skills
- improve-codebase-architecturelkangd/cc-settings-preset
- improve-codebase-architecturehjdspace/spacecode
- improve-codebase-architecturetoverux/cantrips
- improve-codebase-architectureandymelnykov/teamostemplate
- improve-codebase-architecturedaidaij/my-skills
More from Matt Pocock
22 skills
- writing-beats (Skill)
- writing-fragments (Skill)
- setup-matt-pocock-skills (Skill)
- triage (Skill)
- codebase-design (Skill)
- domain-modeling (Skill)
Also listed under: Code review
Sources
- Skill file (SKILL.md)github.com/mattpocock/skills · Backs: Includes scriptsNov 10, 2026
- GitHub repositorygithub.com/mattpocock/skills · Backs: Licence, Publisher, ActivityNov 11, 2026
- Folder in the repository (improve-codebase-architecture)github.com/mattpocock/skills · Backs: Includes scriptsNov 10, 2026