Agent skill

Improve Architecture

by rohitg00 in rohitg00/pro-workflow

Audit an area of the codebase and propose the smallest structural moves that improve it - untangle boundaries, kill duplication, fix seams, break cycles.

No licenceAuto-check passedDevelopment

Install Improve Architecture

skills CLI
$ npx skills add rohitg00/pro-workflow --skill improve-architecture -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install rohitg00/pro-workflow improve-architecture --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/rohitg00/pro-workflow.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/improve-architecture .claude/skills/improve-architecture && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
improve-architecture
GitHub stars
2.9k
Token cost
~641 tokens
SKILL.md length
331 words
Files
1
Skills in repo
41
Repo updated
First seen
Licence
None found

At a glance

Audit an area of the codebase and propose the smallest structural moves that improve it - untangle boundaries, kill duplication, fix seams, break cycles.

  • Works in 5 steps: Map first. Get the current shape before… → Find the strain. Look for the… → Propose the smallest move. For each… → …
  • A codebase feels tangled
  • SKILL.md covers Method, Guardrails and Output
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Improve Architecture is an agent skill from rohitg00/pro-workflow. Audit an area of the codebase and propose the smallest structural moves that improve it - untangle boundaries, kill duplication, fix seams, break cycles. Produces a prioritized plan and decision records, not a rewrite. Use when a codebase feels tangled, hard to change, or is becoming a ball of mud, or when asked to improve or refactor architecture.

Its SKILL.md is about 640 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development, covering Refactoring. The repository describes itself as: Claude Code learns from your corrections: self-correcting memory that compounds over 50+ sessions. Context engineering, parallel worktrees, agent teams, and 17 battle-tested…

When your agent uses it

  • A codebase feels tangled
  • Is becoming a ball of mud
  • Asked to improve
  • Refactor architecture

Example prompts

  • “/improve-architecture”

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Map first. Get the current shape before judging it - entry points,
  2. Find the strain. Look for the load-bearing problems, not style nits
  3. Propose the smallest move. For each problem, the least change that
  4. Rank by leverage. Order the moves by pain relieved over effort. Say which
  5. Record the big calls. For a structural change a future reader would

What it can do on your machine

Read from SKILL.md and the folder at commit 86d5f27. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Improve Architecture loads about 641 tokens when it runs. Until then it costs about 93 tokens; SKILL.md has 331 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~93
When it runs · the whole SKILL.md, loaded when a task matches
~641

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 331 words (~641 tokens).

“Invest in the shape of the system a little at a time rather than paying for a rewrite later. This skill diagnoses and proposes; it does not rewrite on its own.”

— opening of SKILL.md by rohitg00
name
improve-architecture
user-invocable
true

Read the full SKILL.md on GitHub

Files

Just SKILL.md in skills/improve-architecture of rohitg00/pro-workflow.

Open the folder on GitHubat commit 86d5f27

Compare with similar skills

Improve Architecture next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Improve Architecture compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Improve Architecture this skillrohitg00/pro-workflow2.9k—~641Automated safety check: PassNone
Migrate Core Code to Submodulestinyhumansai/openhuman42k—~2.6kAutomated safety check: PassGPL-3.0
Filescope MCPadmica/FileScopeMCP302—~1.7kAutomated safety check: PassProprietary
Gograph Go Repository Intelligenceozgurcd/gograph228—~4.8kAutomated safety check: NotesMIT
Auto DevflowHuangPuStar/FenixAgent552—~3kAutomated safety check: PassApache-2.0
Skill Writingmillionco/expect3.6k—~1.8kAutomated safety check: PassCustom licence

Similar skills

  • Migrate Core Code to Submodules

    tinyhumansai/openhuman

    Plans and carries out moving non-host-specific code and its tests from the OpenHuman core into vendored tiny submodule libraries, then releases the submodule and re-pins the host.

    42k GitHub stars~2.6k tokensUpdated today
    DevelopmentAuto-check passed
  • Filescope MCP

    admica/FileScopeMCP

    Codebase intelligence via FileScopeMCP — symbol lookup, dependency mapping, importance ranking, and semantic search.

    302 GitHub stars~1.7k tokensUpdated 5 mo ago
    DevelopmentAuto-check passed
  • Gives an agent working in a Go codebase a structural view through a local MCP server: call graphs, blast-radius and impact analysis, and bounded first-call exploration.

    228 GitHub stars~4.8k tokensUpdated 2 days ago
    DevelopmentAuto-check: notes
  • Auto Devflow

    HuangPuStar/FenixAgent

    A skill your agent uses when starting an issue, bugfix, feature, or refactor that should be driven by multiple coordinated subagents: explore → plan → code → review, with the main agent acting as…

    552 GitHub stars~3k tokensUpdated today
    DevelopmentAuto-check passed
  • Skill Writing

    millionco/expect

    Write and improve agent skills (SKILL.md files). An agent skill from millionco/expect.

    3.6k GitHub stars~1.8k tokensUpdated 5 mo ago
    DevelopmentAuto-check passed
  • Ss Cpp Modern

    Serial-Studio/Serial-Studio

    Modern C++20 authoring guidance for Serial Studio (Qt 6.11, C++20): concepts, ranges, move/RAII, std smart pointers, constexpr, lock-free SPSC atomics.

    7.2k GitHub stars~1.6k tokensUpdated 2 days ago
    DevelopmentAuto-check passed

More from rohitg00/pro-workflow

All 41 skills in this repo
  • Wiki Builder

    rohitg00/pro-workflow

    Start, structure, and grow a persistent research wiki indexed in pro-workflow's SQLite knowledge base.

    2.9k GitHub stars~1k tokensUpdated 10 days ago
    Auto-check passed
  • LLM Council

    rohitg00/pro-workflow

    Provider-agnostic multi-LLM deliberation. An agent skill from rohitg00/pro-workflow.

    2.9k GitHub stars~1.1k tokensUpdated 10 days ago
    Auto-check passed
  • Survey Generator

    rohitg00/pro-workflow

    Compile a structured literature survey on any AI/ML topic. An agent skill from rohitg00/pro-workflow.

    2.9k GitHub stars~1.6k tokensUpdated 10 days ago
    Auto-check passed
  • Wiki Query

    rohitg00/pro-workflow

    Query pro-workflow wikis via SQLite FTS5 BM25 retrieval. An agent skill from rohitg00/pro-workflow.

    2.9k GitHub stars~554 tokensUpdated 10 days ago
    Auto-check passed
  • Wiki Research Loop

    rohitg00/pro-workflow

    Auto-grow a pro-workflow wiki by running a budget-capped BFS research loop over pluggable source fetchers (web, arXiv, GitHub).

    2.9k GitHub stars~1.5k tokensUpdated 10 days ago
    Auto-check passed
  • Wiki Viewer

    rohitg00/pro-workflow

    Render a self-contained HTML viewer for a pro-workflow wiki.

    2.9k GitHub stars~1.1k tokensUpdated 10 days ago
    Auto-check passed

Questions about Improve Architecture

What does Improve Architecture do?

Audit an area of the codebase and propose the smallest structural moves that improve it - untangle boundaries, kill duplication, fix seams, break cycles. Improve Architecture is an agent skill from rohitg00/pro-workflow. Audit an area of the codebase and propose the smallest structural moves that improve it - untangle boundaries, kill duplication, fix seams, break cycles.

When should I use Improve Architecture?

Improve Architecture fits situations like: A codebase feels tangled; is becoming a ball of mud; asked to improve; refactor architecture.

How do I install Improve Architecture in Claude Code?

Run `npx skills add rohitg00/pro-workflow --skill improve-architecture -a claude-code`. Or copy the skill folder (skills/improve-architecture in rohitg00/pro-workflow) into .claude/skills/improve-architecture in your project. Claude Code loads it when a task matches its description.

How do I install Improve Architecture in Codex?

Run `npx skills add rohitg00/pro-workflow --skill improve-architecture -a codex`. Or copy the skill folder (skills/improve-architecture in rohitg00/pro-workflow) into .agents/skills/improve-architecture in your project. Codex loads it when a task matches its description.

Can I use Improve Architecture in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add rohitg00/pro-workflow --skill improve-architecture -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/improve-architecture, .gemini/skills/improve-architecture, .github/skills/improve-architecture and .opencode/skills/improve-architecture in your project.

What does Improve Architecture need to run?

SKILL.md names no scripts, command-line tools or credentials: Improve Architecture is instructions for the agent only.

Does Improve Architecture access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Improve Architecture safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Improve Architecture use?

No licence was found for Improve Architecture or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Improve Architecture use?

About 641 tokens (SKILL.md is roughly 2.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Improve Architecture?

Skills that share tags, products or a category with Improve Architecture: Migrate Core Code to Submodules (tinyhumansai/openhuman, 42k stars), Filescope MCP (admica/FileScopeMCP, 302 stars), Gograph Go Repository Intelligence (ozgurcd/gograph, 228 stars) and Auto Devflow (HuangPuStar/FenixAgent, 552 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Improve Architecture?

rohitg00 (a GitHub user) maintains it in rohitg00/pro-workflow, which has 2,907 GitHub stars. The repository holds 41 skills in this directory. The repository was last updated on September 29, 2026.

Source: rohitg00/pro-workflow on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.