Architecture Tune-Up
Finds where your code should go deeper and shows it as a visual report.
What it does
Scan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick.
Install in under a minute
Mac or Linux, after you download
unzip architecture-tune-up.zip -d ~/.claude/skills/Windows PowerShell
Expand-Archive architecture-tune-up.zip -DestinationPath $HOME\.claude\skills- Start a new Claude Code session so it sees the skill.
- Ask in plain words, for example: "Use Architecture Tune-Up on this project."
- Unzip the download, then zip just the architecture-tune-up folder if your computer added an extra folder.
- In Claude.ai, open Settings, then Capabilities, and upload it under Skills.
- Turn the skill on and ask Claude to use it.
Architecture Tune-Up uses the open SKILL.md format, so it also works in agents like Cursor, Gemini CLI, GitHub Copilot and Codex. Copy the architecture-tune-up folder into that agent's skills folder, for example .cursor/skills/ or .github/skills/ in your project.
What's inside
The 4 main sections of the SKILL.md, in order.
- Process
- Explore
- Present candidates as an HTML report
- Grilling loop
In the download: agents/openai.yaml, HTML-REPORT.md, LICENSE, NOTICE.md, SKILL.md
Credit and license
Architecture Tune-Up is a renamed, packaged copy of improve-codebase-architecture by Matt Pocock (github.com/mattpocock/skills), used under the MIT license. The license and a list of changes ship inside the download.
Questions
Does Architecture Tune-Up work in Claude.ai, not just Claude Code?
Yes. In Claude.ai, upload the architecture-tune-up folder as a zip in Settings under Capabilities. It also works in other agents that support Agent Skills, like Cursor, Gemini CLI and GitHub Copilot.
What do I get?
A zip with the architecture-tune-up folder: its SKILL.md (2,292 words) and its license files. One payment, instant download.
Who made Architecture Tune-Up?
It's a renamed, packaged copy of improve-codebase-architecture by Matt Pocock, used under the MIT license. The license and a list of changes ship inside the download.