0 Refactor Advisor

    2

    Transform technical debt into a prioritized roadmap with professional-grade refactoring reports.

    Free

    5 installsSecurity scanned

    Works with the AI tools you already use

    Claude CodeClaude CodeCursorCursorCodex CLICodex CLIMuseMuseDotsDots+22 more

    0-refactor-advisor

    Example session with this skill installed

    // userService.js
async function processUser(u, t, r, adminKey) {
  if (adminKey === 'secret_key_2024') {
    if (u && u.email && u.email.includes('@')) {
      const db = require('./db');
      const existing = await db.query(`SELECT * FROM users WHERE email='${u.email}'`);
      if (existing.length === 0) {
        await db.query(`INSERT INTO users (email, type, role) VALUES ('${u.email}', '${t}', '${r}')`);
        console.log('user created');
        // TODO: send welcome email
        const db2 = require('./db');
        await db2.query(`UPDATE stats SET user_count = user_count + 1 WHERE id=1`);
      } else {
        console.log('user exists');
      }
    }
  }
}
    • Read your context and instructions
    • Compiled the 0-refactor-advisor
    • Generated the document

    REFACTOR ADVISOR REPORT
    ════════════════════════════════════════
    File/Module: userService.js — processUser()
    Language: JavaScript (Node.js)
    Lines: ~20
    ════════════════════════════════════════

    TECHNICAL DEBT SCORE: 8/10
    Smells found: 7 total (3 critical · 3 medium · 1 low)

    QUICK WINS (each < 15 min)
    ────────────────────────────

    1. Line 2 — Magic String — extract 'secret_key_2024' to process.env.ADMIN_KEY
    2. Line 13 — Dead Code — remove duplicate const db2 = require('./db'); use existing db
    3. Line 1 — Poor Naming — rename u→user, t→type, r→role

    PRIORITY REFACTORS
    ──────────────────────────────────────────────────────
    #1 Severity: CRITICAL
    Smell: SQL Injection (Magic String in query)
    Location: Lines 6, 8, 10 — template literals inside db.query()
    Problem: String interpolation in SQL queries is not escaped. An attacker controlling
    u.email can exfiltrate or destroy the database.
    Fix: Replace with parameterized queries:

                  db.query('SELECT * FROM users WHERE email = $1', [user.email])
[... abbreviated ...]

    0-refactor-advisor.pdf

    PDF · document

    Generated

    Example file from a real run - the skill writes it into your workspace.

    Connects securely to your tools. The creator never sees your data.

    About this skill

    High-Level Code Quality Analysis

    Refactor Advisor is a specialized developer tool designed to bridge the gap between "working code" and "clean code." It acts as a deep-scanning auditor that identifies technical debt, structural flaws, and security risks using industry-standard patterns like SOLID principles and Martin Fowler’s refactoring catalog.

    What it does

    Unlike generic AI prompts, this skill applies a strict heuristic framework to your codebase. It categorizes issues from "Poor Naming" to "God Classes," calculates a quantitative Technical Debt Score, and identifies "Quick Wins" that provide immediate value with minimal risk.

    • Detailed Auditing: Scans for 10+ specific code smells including Feature Envy, Deep Nesting, and Magic Numbers.
    • Prioritized Reporting: Ranks issues by severity (Critical/Medium/Low) so you know exactly where to start.
    • Risk Management: Explicitly flags when a refactor requires "Tests First" to prevent silent regressions.
    • Framework Agnostic: Works across any language or environment, from legacy Node.js monoliths to modern Python microservices.

    Why use this skill

    Prompting a standard AI to "make my code better" often results in subjective style changes or dangerous rewrites. Refactor Advisor provides a structured report with exact line ranges and concrete transformation steps, ensuring that code quality is improved without breaking existing contracts or introducing security vulnerabilities like SQL injection.

    How to install

    Works the same in every agent - Claude, Cursor, Codex, Copilot and 20+ more.

    ~30 seconds
    1. 1

      Download the ZIP

      Free skills download straight away. Paid skills unlock right after purchase.

    2. 2

      Unzip into your skills folder

      Every agent reads skills from one folder on your machine. Drop the unzipped folder in there.

    3. 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

    5 installs

    Downloaded by developers to date

    Free forever

    No account required to browse

    Trust & safety

    Security scanned

    Verified clean 4 months ago

    • Free to download with an account

    Listed4 months ago

    What's inside

    Frequently Asked Questions