Improve Codebase Architecture
Improve Codebase Architecture is an agent skill (a SKILL.md file) from mattpocock/skills. Scan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick. It works with Claude Code and Codex and has 278,361 GitHub stars across a repository of 15 listed skills.
github.com/mattpocock/skills/skills/engineering/improve-codebase-architecture (opens in a new tab)
- Multi-skill repo
- Plugin marketplace
- Coding
- Actively maintained
Add this skill
Claude
This repository is a Claude Code plugin marketplace. In Claude Code:
/plugin marketplace add mattpocock/skills
/plugin install mattpocock-skills@mattpocockIn the Claude apps, zip the improve-codebase-architecture folder and upload it under Customize > Skills > + > Upload a skill (code execution must be on).
ChatGPT / Codex
Codex reads skills from .agents/skills/ in a repo or ~/.agents/skills/ for every project:
git clone --depth 1 https://github.com/mattpocock/skills.git
cp -r skills/skills/engineering/improve-codebase-architecture .agents/skills/improve-codebase-architecture # repo; ~/.agents/skills for all projectsStandalone skills also load in the ChatGPT desktop app.
Cursor
Cursor loads skills from .cursor/skills/ (or ~/.cursor/skills/) and also reads .claude/skills/:
git clone --depth 1 https://github.com/mattpocock/skills.git
cp -r skills/skills/engineering/improve-codebase-architecture .cursor/skills/improve-codebase-architecture # project; ~/.cursor/skills for all projectsSource (checked Oct 7, 2026): code.claude.com/docs/en/skills (opens in a new tab), code.claude.com/docs/en/plugin-marketplaces (opens in a new tab), support.claude.com/en/articles/12512180-using-skills-in-claude (opens in a new tab), learn.chatgpt.com/docs/build-skills (opens in a new tab), cursor.com/docs/context/skills (opens in a new tab)
What this skill does
Scan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick. Surface architectural friction and propose deepening opportunities: refactors that turn shallow modules into deep ones. The aim is testability and AI-navigability.
More skills in mattpocock/skills
15 skills are listed from this repository.
TDDmattpocock/skills
Similar skills
More coding skills
Requesting Code Review
obra/superpowers
Use when completing tasks, implementing major features, or before merging to verify work meets requirements.
CodingShellReceiving Code Review
obra/superpowers
Use when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not…
CodingShellMCP Builder
anthropics/skills
Guide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools.
OfficialCodingPythonClaude API
anthropics/skills
Reference for the Claude API / Anthropic SDK — model ids, pricing, params, streaming, tool use, MCP, agents, caching, token counting, model migration.
OfficialCodingPythonPonytail
DietrichGebert/ponytail
Forces the laziest solution that actually works, simplest, shortest, most minimal.
CodingJavaScriptPonytail Review
DietrichGebert/ponytail
Code review focused exclusively on over-engineering.
CodingJavaScript
What is the Improve Codebase Architecture skill?
Improve Codebase Architecture is an agent skill (a SKILL.md file) from mattpocock/skills. Scan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick. It works with Claude Code and Codex and has 278,361 GitHub stars across a repository of 15 listed skills. Its SKILL.md lives at github.com/mattpocock/skills/skills/engineering/improve-codebase-architecture.
How do I install the Improve Codebase Architecture skill?
In Claude Code, run /plugin marketplace add mattpocock/skills and then /plugin install mattpocock-skills@mattpocock. For Codex or Cursor, copy the improve-codebase-architecture folder into .agents/skills/ or .cursor/skills/.
Is the Improve Codebase Architecture skill free?
Yes. The repository is open source under the MIT license.
Is Improve Codebase Architecture maintained?
The repository's most recent commit was on Oct 6, 2026. Its latest release is v1.3.1. appsgit only lists skills from repositories with a commit in the last six months.