Refactor master
Skill DominikTobureto/awesome-grok-build/.grok/skills/refactor-master
Grok Build resources, reusable .grok/skills, AGENTS.md templates, hooks, prompts, and starter workflows.
npx -y skills add DominikTobureto/awesome-grok-build --skill refactor-masterAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
What its author says it does
Copied from the file, not written here
Use for behavior-preserving refactors, modularization, dead-code removal, dependency untangling, naming cleanup, or extracting reusable components without changing product behavior.
SKILL.md
1.7 KB, as published. Nobody here has run it
Refactor Master
Improve structure without changing behavior.
Grok Build Mode
- Always start in Plan Mode for multi-file refactors.
- Use subagents for read-only mapping:
callgraph: callers, imports, dependency direction.tests: existing coverage and missing characterization tests.risk: public APIs, migrations, generated files, fragile areas.cleanup: duplication and naming candidates.
- Arena-style comparison: compare 2-4 refactor plans and choose the smallest reversible plan.
- Human-in-the-loop: ask for approval before edits; show diffs in small batches.
Workflow
- Define the behavior that must not change.
- Identify the smallest refactor boundary.
- Add characterization tests if behavior is not covered.
- Move/rename/extract in small steps.
- Run tests after each meaningful step.
- Avoid opportunistic rewrites outside scope.
Refactor Rules
- Do not mix refactor and feature changes.
- Preserve public APIs unless approved.
- Keep commits separable: tests, mechanical move, cleanup.
- Prefer existing abstractions over new frameworks.
- If a refactor requires many files, propose checkpoints.
Example Prompts
Use refactor-master. Plan a behavior-preserving extraction of this module. Add characterization tests before edits.
Find the smallest refactor that reduces duplication here. Use subagents for callgraph, tests, and risk. Wait for approval.