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, Codex, Cursor, Gemini CLI, GitHub Copilot and OpenCode and has 303,491 GitHub stars across a repository of 15 listed skills.
github.com/mattpocock/skills/skills/engineering/improve-codebase-architecture (opens in a new tab)
Data as of from the GitHub API and skills.sh; description from the skill's SKILL.md. Report an error
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.
Active · last commit Oct 21, 2026
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.
Maintained · last commit Oct 9, 2026
OfficialCodingPythonPrisma Driver Adapter Implementation
prisma/skills
Required reference for Prisma ORM 7 SQL driver adapter work.
Maintained · last commit Oct 16, 2026
OfficialCodingPonytail Review
DietrichGebert/ponytail
Quality review of a change: is the logic right, is it safe, does it hold under real load, is risky code tested, is it fast enough, and is every line needed.
Active · last commit Oct 18, 2026
CodingJavaScriptServer Side Conversion Tracking
autonnel/autonnel-skills
Set up server-side conversion tracking so purchases are reported accurately to Facebook, TikTok, Google and Bing despite iOS restrictions, ad blockers and cookie loss.
Too new to judge · created Aug 5, 2026
CodingX402
browser-use/browser-use
Set up Browser Use Cloud payments with x402 — pay per request from a crypto wallet (USDC on Base mainnet), no signup or API key.
Active · last commit Oct 22, 2026
OfficialCodingPython
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 19, 2026. Its latest release is v1.3.1. appsgit only lists skills from repositories with a commit in the last six months.