Refactoring Scan

Analyze codebases to identify and prioritize refactoring candidates using churn, complexity, and stability metrics.

11|3|Updated Jan 29, 2026
One-click install
npx skills add https://github.com/artk0de/TeaRAGs-MCP --skill refactoring-scan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Refactoring Scan
Source: https://github.com/artk0de/TeaRAGs-MCP/tree/main/.claude-plugin/tea-rags/skills/refactoring-scan
Command: npx skills add https://github.com/artk0de/TeaRAGs-MCP --skill refactoring-scan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill solves the challenge of identifying high-impact refactoring candidates in large codebases by moving beyond simple keyword search to analyze code history, churn, and complexity.

Core Features & Use Cases

  • Multi-Preset Scanning: Simultaneously evaluates code for mechanical refactoring, decomposition candidates, and stability risks.
  • Tiered Prioritization: Automatically categorizes findings into high, medium, and low value based on the convergence of multiple signals.
  • Use Case: When a codebase becomes difficult to maintain, use this skill to surface specific functions that are both complex and frequently modified, allowing you to focus your refactoring efforts where they provide the most stability.

Quick Start

Ask the agent to perform a refactoring scan on the src directory to identify high-priority cleanup candidates.

Frequently Asked Questions about Refactoring Scan

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

FAQPage Schema
How do I identify high-priority refactoring candidates in a large codebase?

To identify refactoring candidates, this skill cross-references code churn, complexity, and stability metrics across large-scale repositories to surface specific functions that are both complex and frequently modified, categorizing technical debt into actionable high, medium, and low priority tiers.

What is the best way to find technical debt hotspots before they cause stability issues?

Finding technical debt hotspots involves moving beyond simple keyword search to analyze code history. This skill uses multi-preset scanning to simultaneously evaluate code for mechanical refactoring needs, decomposition candidates, and stability risks by converging multiple metric signals.

How do I run a refactoring scan to prioritize code cleanup efforts?

Running a refactoring scan requires pointing the agent at your target source directory. The skill then utilizes search-cascade decision trees to execute multi-preset scans, automatically evaluating the codebase and classifying discovered technical debt into prioritized, actionable tiers.

Can I use this refactoring scan on large-scale repositories with high code churn?

Yes, this refactoring scan is specifically designed to operate across large-scale repositories. It effectively handles high code churn by cross-referencing those churn metrics with complexity and stability data to surface high-value targets for decomposition or simplification.

What distinguishes this technical debt analysis from a standard code complexity checker?

Unlike standard code complexity checkers that only evaluate static code, this technical debt analysis cross-references code history and churn with complexity and stability metrics to identify refactoring targets that provide the highest maintenance value and stability improvements.