Works with the AI tools you already use
Claude Code
Cursor
Codex CLI
GitHub Copilot
Gemini CLI+20 moreClaude CodeCursorCodex CLIGitHub CopilotGemini CLI
OpenClaw
Manus
Grok+17 agentsCodebase Architecture Improver
This skill transforms sprawling, "organically grown" repositories into logically structured architectures without the high risk of a full rewrite.
$5
Codebase Architecture Improver
Example session with this skill installed
Our Express/TypeScript backend is about 40k lines. There is a shared utils/ folder that everything imports and a 3,000-line OrderService class. I've pasted the madge output below: it shows cycles between orders, billing and notifications.
- Read your context and instructions
- Compiled the codebase architecture improver
- Generated the UI component
Architecture assessment: the orders, billing and notifications cycle and the OrderService god object share one cause, and can be fixed in five safe steps.
Dependency map (from your madge output)
orders -> billing -> notifications -> orders
\ | |
+----> utils/ <--------+
utils/ is imported by every module, so it acts as a hidden shared layer.
Boundary analysis
| Module | Problem |
|---|---|
| orders | OrderService mixes pricing, persistence, billing calls and emails |
| billing | Imports order types from orders directly |
| notifications | Reads order details by calling back into orders |
| utils | Holds domain logic next to generic helpers |
Safe refactoring sequence
Move shared types (Order, Invoice) into a contracts/ module with no imports. This breaks the type-level cycles.
2. Split utils/ into generic helpers and domain code, and move domain code to its owning module.
3. Replace callbacks with events: orders emits OrderPlaced; billing and notifications subscribe.
4.
Extract from OrderService one responsibility at a time: pricing, then persistence, then side effects. Keep the old methods delegating until callers move.
5. Add a lint rule (dependency-cruiser or madge in CI) that fails on new cycles.
Each step can ship on its own and keeps behaviour unchanged.
Next steps
- Start with step 1 and rerun madge
- Add characterisation tests around OrderService before step 4
codebase-architecture-improver.tsx
TSX · React component
Example file from a real run - the skill writes it into your workspace.
Connects securely to your tools. The creator never sees your data.
What you get
About this skill
What it does
This skill transforms sprawling, "organically grown" repositories into logically structured architectures without the high risk of a full rewrite. It identifies the root causes of technical debt—such as circular dependencies, layering violations, and god objects—and provides a systematic, step-by-step roadmap to fix them.
Why use this skill
Unlike generic AI prompting, the Codebase Architect uses a specific diagnostic methodology: it triages pain points, maps actual dependency directions, and identifies "seams" for decoupled testing. It doesn't just suggest clean code; it sequences refactoring steps to ensure the codebase remains functional throughout the transition. It is specifically designed to help developers who are inheriting legacy systems or scaling a startup MVP into a maintainable enterprise application.
Supported Tools & Frameworks
The skill is language-agnostic but excels with modular frameworks in TypeScript/JavaScript, Python, Go, and Java. It produces outputs tailored to your workflow, whether you need a high-level executive audit, a technical refactoring sequence, or team-wide architectural conventions.
The Result
You receive a concrete dependency map, a list of boundary violations, and a prioritized sequence of "micro-updates" that incrementally improve the system's modularity and reduce change-cost.
How to install
Works the same in every agent - Claude, Cursor, Codex, Copilot and 20+ more.
- 1
Download the ZIP
Free skills download straight away. Paid skills unlock right after purchase.
- 2
Unzip into your skills folder
Every agent reads skills from one folder on your machine. Drop the unzipped folder in there.
- 3
Ask your agent to use it
Restart the agent if it was already running. It picks the skill up automatically - no config needed.
Skills folder by agent
Click the path to copy it. Create the folder if it does not exist yet.
Reviews
No reviews yet
Be one of the first to try it. Every listed skill passes our trust checks below.
Security scanned
Passed our 8-point scan before listing
Fresh listing
Recently published to Agensi
30-day refund
Not a fit? Get your money back
Trust & safety
Security scanned
Verified clean 3 months ago
- Passed all security checks, Safe to install