Improve Codebase Architecture

Improve Codebase Architecture is an AI Engineering skill for Claude Code, published by tt-a1i in matt-skills-with-to-goal.

29 stars7 forkson tt-a1i/matt-skills-with-to-goalAdded 2026/08/12+32% in starsRepository updated 2026/08/11

View source on GitHub Download repo ZIP

agent-skillsai-agentsclaude-codecodexcoding-agentsdeveloper-toolsworkflow

Install in seconds

Install Improve Codebase Architecture

Copy Improve Codebase Architecture into your Claude Code skills folder. Run the command in your terminal, or review the source on GitHub before installing.

terminal

npx degit https://github.com/tt-a1i/matt-skills-with-to-goal/tree/main/skills/engineering/improve-codebase-architecture ~/.claude/skills/improve-codebase-architecture

Requires Node.js. Downloads this skill only — not the rest of the repository — into your Claude Code skills folder.

Without Node.js

git clone https://github.com/tt-a1i/matt-skills-with-to-goal.git

Clones the whole repository, then copy the skill’s own directory into your skills folder yourself.

In this catalog

Source file: skills/engineering/improve-codebase-architecture/SKILL.md in tt-a1i/matt-skills-with-to-goal
Installs to: ~/.claude/skills/improve-codebase-architecture
Collection: One of 40 skills cataloged from this repository
Category: AI Engineering — 2451 skills

What Improve Codebase Architecture does

Improve Codebase Architecture scans a codebase for shallow modules and deepening opportunities, then generates an HTML report of candidates. It is used to find refactors that improve locality, testability, and AI navigability before drilling into one choice.

Improve Codebase Architecture is cataloged under AI Engineering on DirSkills. Improve Codebase Architecture comes from a repository tagged agent-skills, ai-agents, claude-code, codex and coding-agents.

Documentation

README

Excerpt

Improve Codebase Architecture

Surface architectural friction and propose deepening opportunities — refactors that turn shallow modules into deep ones. The aim is testability and AI-navigability.

This command is informed by the project's domain model and built on a shared design vocabulary:

This is the opening of the README. Read the full README on GitHub.

Commands Improve Codebase Architecture provides

Slash commands named in this skill’s SKILL.md, listed in the order they first appear.

/codebase-design
/grilling
/domain-modeling

Frequently asked about Improve Codebase Architecture

What else does tt-a1i publish alongside Improve Codebase Architecture?
Improve Codebase Architecture is one of 40 skills that DirSkills catalogs from tt-a1i/matt-skills-with-to-goal, the repository it ships in. Its siblings there include Agent Handoff, Ask Matt and Ask Matt. Each one is a separate skill with its own page in this directory, installs the same way Improve Codebase Architecture does, and is maintained by tt-a1i in that same repository. The rest of the collection is listed on the tt-a1i/matt-skills-with-to-goal page.
How does Improve Codebase Architecture compare to other AI Engineering skills?
Improve Codebase Architecture ranks #2324 by stars among the 2451 AI Engineering skills in this catalog. The most-starred ones next to it are Architecture Decision Records, AI-First Engineering and Agentic OS. DirSkills ranks by the star count of the repository each skill ships in, so that order reflects how popular those repositories are rather than any review of Improve Codebase Architecture against them. Open each page to compare what they document and how they install.