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/.
You Might Also Like
Related Skills
coding-agent
Run Codex CLI, Claude Code, OpenCode, or Pi Coding Agent via background process for programmatic control.
openclaw
add-uint-support
Add unsigned integer (uint) type support to PyTorch operators by updating AT_DISPATCH macros. Use when adding support for uint16, uint32, uint64 types to operators, kernels, or when user mentions enabling unsigned types, barebones unsigned types, or uint support.
pytorchat-dispatch-v2
Convert PyTorch AT_DISPATCH macros to AT_DISPATCH_V2 format in ATen C++ code. Use when porting AT_DISPATCH_ALL_TYPES_AND*, AT_DISPATCH_FLOATING_TYPES*, or other dispatch macros to the new v2 API. For ATen kernel files, CUDA kernels, and native operator implementations.
pytorchskill-writer
Guide users through creating Agent Skills for Claude Code. Use when the user wants to create, write, author, or design a new Skill, or needs help with SKILL.md files, frontmatter, or skill structure.
pytorch
implementing-jsc-classes-cpp
Implements JavaScript classes in C++ using JavaScriptCore. Use when creating new JS classes with C++ bindings, prototypes, or constructors.
oven-shimplementing-jsc-classes-zig
Creates JavaScript classes using Bun's Zig bindings generator (.classes.ts). Use when implementing new JS APIs in Zig with JSC integration.
oven-sh