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.
Install
npx skills add jscraik/Agent-Skills --skill improve-codebase-architecturegit 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-architecturePersonal 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,
Details
- Skill name
improve-codebase-architecture- Repository
- jscraik/Agent-Skills
- 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
1password
9jscraik/Agent-Skills
Plan, diagnose, and validate 1Password CLI workflows. Use when tasks need op CLI sign-in, secret references, op run, op inject, item reads, env injection, or service-account secret access.
Agentation
9jscraik/Agent-Skills
Audit, validate, and troubleshoot Agentation integrations in frontend apps. Use when annotations, MCP registration, endpoint sync, webhook delivery, or watch mode readiness are failing.
Agents Md
9jscraik/Agent-Skills
Use when reviewing, creating, shrinking, or refactoring AGENTS.md and directly linked instruction guidance for stale or conflicting rules against current model documentation, scoped routing, deduplication, or progressive disclosure.
Javascript Pro
9jscraik/Agent-Skills
Create and debug modern JavaScript code with ES6+, async patterns, and Node.js APIs. Use when working on runtime behavior, promises, or browser and Node compatibility.
He Plan
9jscraik/Agent-Skills
Create bounded Harness Engineering execution plans from approved specs or issue slices. Use when work needs ordered implementation units, explicit scope boundaries, rollback posture, traceability, and validation gates before code changes.
Keep Codex Fast
9jscraik/Agent-Skills
Diagnose Codex Desktop or CLI local-state bloat and safe recovery options. Use when sessions, archived history, logs, worktrees, or stale Codex config may be making Codex feel slow.
Browse the most popular Claude skills, all software development skills, or write your own with the skills generator.