← ClaudeAtlas

improvelisted

Use when the codebase needs a structured audit, audit-driven plans, execution of those plans, or a focused refactoring/simplification pass. Covers correctness, security, performance, tech debt, migrations, DX, direction, and code cleanup in one skill. Common triggers: improve, audit, tech debt, tech debt audit, audit codebase, improve codebase, direction, audit and plan, refactor this, refactoren, code cleanup, opschonen, simplify this code, vereenvoudigen, remove over-engineering, deduplicate logic, restructure this code, reduce complexity, untangle this, clean architecture mess.
MarkBovee/agent-skills-kit · ★ 1 · AI & Automation · score 72
Install: claude install-skill MarkBovee/agent-skills-kit
# ASK Improve Structured, evidence-first codebase audit that produces executable implementation plans. Also covers focused refactoring and simplification passes. Runs once to audit and plan; re-invoke `execute`, `reconcile`, or `next` modes for follow-through. ## When to use Use when: - you want a structured audit (correctness, security, performance, tech debt, deps, DX, docs, direction, user-facing text language/locale consistency) - you have audit output and need executable implementation plans - you need to execute, reconcile, or publish those plans as issues - the user asks for a refactor, cleanup, simplification, or deduplication Skip when: - the problem is a single known bug (use `debugging`) - you only need a quick code review (use `code-review`) ## Audit flow 1. **Recon**: detect repo layout, conventions, commands, existing docs/ADRs, intent signals (TODOs, flags, stubs, PRDs, roadmap) 2. **Audit**: run category audits, including code-smell scanning — each finding is evidence-grounded (`file:line`) 3. **Plan**: convert findings into self-contained, executor-ready plans with drift checks, verification gates, hard boundaries, and escape hatches 4. **Follow-through**: `execute <plan>`, `reconcile`, `next`, `branch` For significant or release-sensitive work, act as the independent audit role: inspect callers and the complete diff, challenge ownership, ambiguity, fallbacks, determinism, compatibility, and test invariants. Return concrete evidence, not generic qualit