refactor-audit

Audit codebases for technical debt and generate prioritized refactoring plans.

1|Updated Feb 15, 2026
One-click install
npx skills add https://github.com/fabis94/fabis-ralph-loop --skill refactor-audit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: refactor-audit
Source: https://github.com/fabis94/fabis-ralph-loop/tree/main/.universal-ai-config/skills/refactor-audit
Command: npx skills add https://github.com/fabis94/fabis-ralph-loop --skill refactor-audit

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill systematically identifies and prioritizes technical debt within a codebase, generating an actionable refactoring plan to improve maintainability and reduce future development friction.

Core Features & Use Cases

  • Comprehensive Auditing: Analyzes for dead code, complexity, duplication, dependency issues, type safety gaps, test coverage, architectural flaws, security smells, and readability problems.
  • Prioritized Planning: Outputs a tiered refactoring plan, from high-level subtasks for AI loops to precise file-level changes for immediate execution.
  • Use Case: Run this Skill quarterly to proactively manage tech debt, ensuring the codebase remains healthy and easier to evolve.

Quick Start

Audit the 'packages/server' directory and generate a detailed refactoring plan.

Frequently Asked Questions about refactor-audit

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit my codebase for technical debt and create a refactoring plan?

To audit technical debt and generate a refactoring plan, specify a codebase scope for analysis. The audit evaluates dead code, complexity, duplication, type safety, and security, then outputs a tiered refactoring plan with actionable file-level changes.

What is the best way to prioritize refactoring tasks to improve code maintainability?

Prioritizing refactoring tasks to improve maintainability is done by analyzing static analysis results and git history. This process identifies technical debt categories like complexity and architectural flaws, generating a prioritized refactoring plan based on actual code health.

Can I generate refactoring subtasks for AI execution from a code audit?

Yes, you can generate refactoring subtasks for AI execution from a code audit. The audit produces a prioritized refactoring plan at user-defined detail levels, including high-level subtasks specifically designed for AI execution loops.

Does the technical debt audit analyze test coverage and dependency health?

Yes, the technical debt audit analyzes both test coverage and dependency health. It systematically evaluates specified codebase scopes across multiple categories including dependency issues, test coverage gaps, type safety, and security smells to inform findings.

When should I run a code audit to manage technical debt?

You should run a code audit to manage technical debt quarterly. Running this audit proactively ensures the codebase remains healthy, reduces future development friction, and maintains overall maintainability as the project evolves.

What categories of code quality issues does a static analysis audit identify?

A static analysis audit identifies code quality issues across categories including dead code, complexity, duplication, dependency health, type safety gaps, test coverage, architectural flaws, security smells, and readability problems to generate actionable refactoring plans.