Improve Codebase Architecture

Review code architecture, code quality, dependency graphs, coupling, technical debt, modularization, ownership, and test seams. Use when refactors, restructuring, tightly coupled code, or architecture decisions need proof-backed options.

9 stars 4 forksSoftware Development

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add jscraik/Agent-Skills --skill improve-codebase-architecture
Manual install
git clone --depth 1 https://github.com/jscraik/Agent-Skills.git /tmp/Agent-Skills
mkdir -p ~/.claude/skills
cp -r /tmp/Agent-Skills/Skills/agent-ops/improve-codebase-architecture ~/.claude/skills/improve-codebase-architecture

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Improve Codebase Architecture

Prefer the smallest evidence-backed architecture move. A design is professional only when source authority, public surface, callers, and verification are clear.

## When To Use
Use for architecture review, dependency graphs, modularization, ownership, public interfaces, projection boundaries, test seams, and patch-vs-interface decisions.

- Do not use for one failing test, plain cleanup, or style-only refactors.
- Do not begin a broad rewrite before owner, caller, migration, rollback, and
  verifier proof exist.

## Inputs
Target path, user request, instructions, checkout or worktree, current diff,
owner signal, public interface, callers, tests, generated/projection paths,
decision records, maintained entrypoints, registration or routing surfaces,
operator or agent discovery paths, and tracker/log evidence.

## Outputs
Return concise prose by default. For risky, blocked, handoff, or eval-proof work, use references/output-schema.md and include source-of-truth, public surface, caller map, change class, boundary verdict, patch/interface designs, first move, validation, and schema_version.

## Workflow
1. Resolve the exact target, task identity, active instructions, checkout or
   worktree, current diff, and requested mutation boundary.
2. Run an applicability preflight before design analysis: confirm the target
   and patch or package shape match the repository, locate canonical ownership,
Read the full skill on GitHub

Details

Skill name
improve-codebase-architecture
Path
Skills/agent-ops/improve-codebase-architecture/SKILL.md
License
Apache-2.0
Repo updated
16 November 2026

FAQ

What does the Improve Codebase Architecture skill do?

Review code architecture, code quality, dependency graphs, coupling, technical debt, modularization, ownership, and test seams. Use when refactors, restructuring, tightly coupled code, or architecture decisions need proof-backed options.

How do I install the Improve Codebase Architecture skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add jscraik/Agent-Skills --skill improve-codebase-architecture. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Improve Codebase Architecture popular?

It lives in jscraik/Agent-Skills, which has 9 GitHub stars and 4 forks.

Related skills

Browse the most popular Claude skills, all software development skills, or write your own with the skills generator.