refactor

by @solatis in Development

557

# Install this skill:

npx skills add solatis/claude-config --skill "refactor"

Install specific skill from multi-skill repository

# Description

Invoke IMMEDIATELY via python script when user requests refactoring analysis, technical debt review, or code quality improvement. Do NOT explore first - the script orchestrates exploration.

# SKILL.md

name: refactor
description: Invoke IMMEDIATELY via python script when user requests refactoring analysis, technical debt review, or code quality improvement. Do NOT explore first - the script orchestrates exploration.

Refactor

When this skill activates, IMMEDIATELY invoke the script. The script IS the workflow.

Invocation

Argument	Required	Description
`--step`	Yes	Current step (starts at 1)
`--total-steps`	Yes	Total steps (5 for full workflow)
`--n`	No	Number of categories to explore (default: 10)

Do NOT explore or analyze first. Run the script and follow its output.

Workflow Phases

Dispatch - Launch parallel Explore agents (one per category)
Triage - Structure smell findings with IDs
Cluster - Group smells by shared root cause
Contextualize - Extract user intent, prioritize issues
Synthesize - Generate actionable work items

Determining N (category count)

Default: N = 10

Adjust based on user request scope:

SMALL (single file, specific concern, "quick look"): N = 5
MEDIUM (directory, module, standard analysis): N = 10
LARGE (entire codebase, "thorough", "comprehensive"): N = 25

The script randomly selects N categories from the 38 available code quality categories defined in conventions/code-quality/.

# Supported AI Coding Agents

This skill is compatible with the SKILL.md standard and works with all major AI coding agents:

⚡ Amp 🚀 Antigravity 🤖 Claude Code 🦀 Clawdbot 📝 Codex ▶️ Cursor 🤖 Droid 💎 Gemini CLI 🐙 GitHub Copilot 🪿 Goose 📊 Kilo Code 🔧 Kiro CLI 💻 OpenCode 🦘 Roo Code 🌲 Trae 🏄 Windsurf

Learn more about the SKILL.md standard and how to use these skills with your preferred AI coding agent.