refactor
This skill automates code refactoring analysis by orchestrating parallel exploration agents across code quality categories. It follows a structured 5-step workflow from discovery to actionable recommendations, with configurable scope based on project size. The tool enforces immediate script execution without preliminary analysis.
Packaged view
This page reorganizes the original catalog entry around fit, installability, and workflow context first. The original raw source lives below.
Install command
npx @skill-hub/cli install solatis-claude-config-refactor
Repository
Skill path: skills/refactor
This skill automates code refactoring analysis by orchestrating parallel exploration agents across code quality categories. It follows a structured 5-step workflow from discovery to actionable recommendations, with configurable scope based on project size. The tool enforces immediate script execution without preliminary analysis.
Open repositoryBest for
Primary workflow: Research & Ops.
Technical facets: Full Stack.
Target audience: Developers and technical leads working on legacy codebases or conducting systematic code quality reviews who need structured refactoring analysis..
License: Unknown.
Original source
Catalog source: SkillHub Club.
Repository owner: solatis.
This is still a mirrored public skill entry. Review the repository before installing into production workflows.
What it helps with
- Install refactor into Claude Code, Codex CLI, Gemini CLI, or OpenCode workflows
- Review https://github.com/solatis/claude-config before adding refactor to shared team environments
- Use refactor for development workflows
Works across
Favorites: 0.
Sub-skills: 0.
Aggregator: No.
Original source / Raw 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 <invoke working-dir=".claude/skills/scripts" cmd="python3 -m skills.refactor.refactor --step 1 --total-steps 5 --n 10" /> | 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 1. **Dispatch** - Launch parallel Explore agents (one per category) 2. **Triage** - Structure smell findings with IDs 3. **Cluster** - Group smells by shared root cause 4. **Contextualize** - Extract user intent, prioritize issues 5. **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/.