Use when adding new error messages to React, or seeing "unknown error code" warnings.
refactor
557
95
# 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/.
# Related Skills
Use when feature flag tests fail, flags need updating, understanding @gate pragmas, debugging...
Use when you have lint errors, formatting issues, or before committing code to ensure it passes CI.
Use when you need to check feature flag states, compare channels, or debug why a feature behaves...
# 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.