
Improve codebase architecture
Scan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick.
- Scripts
- None
- Platforms
- Claude Code, Codex, Cursor
- GitHub stars
- 326K
- Last commit
- today
- License
- MIT
- Listing updated
- today
When your agent uses it
Scan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick.
From the skill's SKILL.md. Your agent reads this description to decide when to load the skill.
What it can access
From a static check of its 3 files (13 KB) on GitHub on 17 November 2026. Nothing was run. Read the files before you install a skill: it can tell your agent to run anything its tools allow.
Install
Copy the skill folder to ~/.claude/skills/improve-codebase-architecture to use it in all your projects:
tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/mattpocock/skills.git "$tmp" &&
mkdir -p ~/.claude/skills &&
rm -rf ~/.claude/skills/improve-codebase-architecture &&
cp -R "$tmp/skills/engineering/improve-codebase-architecture" ~/.claude/skills/improve-codebase-architecture &&
rm -rf "$tmp"For one project only, put the folder in .claude/skills/improve-codebase-architecture inside it instead.
Copy the skill folder to ~/.agents/skills/improve-codebase-architecture to use it in every repository:
tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/mattpocock/skills.git "$tmp" &&
mkdir -p ~/.agents/skills &&
rm -rf ~/.agents/skills/improve-codebase-architecture &&
cp -R "$tmp/skills/engineering/improve-codebase-architecture" ~/.agents/skills/improve-codebase-architecture &&
rm -rf "$tmp"For one repository only, put the folder in .agents/skills/improve-codebase-architecture inside it instead.
Copy the skill folder to ~/.cursor/skills/improve-codebase-architecture to use it in every project:
tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/mattpocock/skills.git "$tmp" &&
mkdir -p ~/.cursor/skills &&
rm -rf ~/.cursor/skills/improve-codebase-architecture &&
cp -R "$tmp/skills/engineering/improve-codebase-architecture" ~/.cursor/skills/improve-codebase-architecture &&
rm -rf "$tmp"For one project only, put the folder in .cursor/skills/improve-codebase-architecture inside it instead.
Run in a terminal (add --scope workspace to install it for the current workspace only):
gemini skills install https://github.com/mattpocock/skills.git --path skills/engineering/improve-codebase-architectureOr copy the folder to ~/.gemini/skills/improve-codebase-architecture yourself.
For GitHub Copilot in VS Code, copy the skill folder to ~/.copilot/skills/improve-codebase-architecture:
tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/mattpocock/skills.git "$tmp" &&
mkdir -p ~/.copilot/skills &&
rm -rf ~/.copilot/skills/improve-codebase-architecture &&
cp -R "$tmp/skills/engineering/improve-codebase-architecture" ~/.copilot/skills/improve-codebase-architecture &&
rm -rf "$tmp"For one project only, put the folder in .github/skills/improve-codebase-architecture inside it instead.
Get the folder:
git clone --depth 1 https://github.com/mattpocock/skills.gitThen copy skills/skills/engineering/improve-codebase-architecture into your agent's skills folder as improve-codebase-architecture. Agents that support SKILL.md read one folder per skill.
Improve codebase architecture FAQ
How do I install Improve codebase architecture in Claude Code?
Copy the skill folder from GitHub to ~/.claude/skills/improve-codebase-architecture to use it in all your projects, or to .claude/skills/improve-codebase-architecture in one project.
Does Improve codebase architecture run scripts?
No. It is instructions only, with no scripts. This comes from a static check of the files on GitHub; nothing was run. Read the files before you install it.
Which AI agents can use Improve codebase architecture?
Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, Windsurf and Goose. Each reads skills in the SKILL.md format from its own folder; the install steps on this page list them.
More from mattpocock/skills


Review the changes since a fixed point (commit, branch, tag, or merge-base) along two axes: Standards (does the code follow this repo's docu
- Open source
- 326K GitHub stars
- Developer tools

Shared vocabulary for designing deep modules
- Open source
- 326K GitHub stars
- Design and media



A relentless interview to sharpen a plan or design, which also creates docs (ADR's and glossary) as we go.
- Open source
- 326K GitHub stars