Safe refactor

Skill yeaight7/agent-powerups/plugins/codebase-maintenance/skills/safe-refactor

Curated power-ups for coding agents: skills, slash commands, MCP configs, hooks, AGENTS.md templates, and workflows for serious software engineering. Claude Code, Codex, Antigravity CLI, Cursor and more

Install

npx -y skills add yeaight7/agent-powerups --skill safe-refactor

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

6 stars6 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Use when code needs restructuring without changing observable behavior.

SKILL.md

1.9 KB, as published. Nobody here has run it

Purpose

Restructure code in small, safe steps while preserving all externally observable behavior. Prevents refactor regressions where behavior silently changes.

When to Use

Code needs structural improvement but its public API must remain unchanged.
Naming, organization, or duplication needs cleanup after a feature is complete.
Technical debt needs reduction without introducing risk.

Do not use this skill if there are no existing tests — write tests first.

Inputs

Code to refactor.
Existing test suite (required).
Optional: specific goals (extract function, rename module, remove duplication).

Workflow

Confirm behavior — Run the test suite. All tests must pass before starting.
Plan — List the structural changes. Check each for API impact.
Refactor in small steps — One change at a time, each independently reversible.
Avoid interface changes — Do not alter public APIs, exported types, or CLI behavior unless explicitly intended.
Validate after each step — Re-run targeted tests after each meaningful change.

Output

Changed:
- <structural change 1>
- <structural change 2>

Behavior unchanged because: <reasoning>

Validated by: <test commands run>

Verification

Tests pass before starting
Each step is small and independently reversible
No unintended API or interface changes introduced
Tests pass after each meaningful step
Final test suite fully green

Failure Modes

Missing tests — Stop. Write tests before refactoring. Behavior cannot be verified otherwise.
Silent API change — If a refactor touches public interfaces, stop and confirm this is intentional.
Bundled unrelated changes — Keep each step focused. Mixed changes make rollback and blame impossible.