Find deepening opportunities in a codebase, informed by the domain language in CONTEXT.md and the decisions in docs/adr/. Use when the user wants to improve architecture, find refactoring opportunities, consolidate tightly-coupled modules, or make a codebase more testable and AI-navigable.
Install
npx skills add mattpocock/skills --skill improve-codebase-architecturenpx skills add mattpocock/skills --skill improve-codebase-architecture -a claude-code -gnpx skills add mattpocock/skills --skill improve-codebase-architecture -a codex -ggemini skills install https://github.com/mattpocock/skills.git --path skills/engineering/improve-codebase-architecturegh skill install mattpocock/skills improve-codebase-architecturegit clone --depth 1 https://github.com/mattpocock/skills /tmp/mattpocock__skills
mkdir -p ~/.claude/skills ~/.agents/skills
cp -R /tmp/mattpocock__skills/skills/engineering/improve-codebase-architecture ~/.claude/skills/improve-codebase-architecture # Claude Code
cp -R /tmp/mattpocock__skills/skills/engineering/improve-codebase-architecture ~/.agents/skills/improve-codebase-architecture # Codex, Cursor, Gemini CLI, Copilot, OpenCode