Skip to content
Agentmart
Submit a tool

safe-refactor

Performs behavior-preserving refactors with a tight verify loop.

Skill by X-McKay

IndexedApache-2.0
Write a review

Install

Works with Claude Code, Claude apps, Codex, Cursor, Gemini CLI, GitHub Copilot, VS Code, OpenCode, Goose, Windsurf. Read the repository before you give any tool access to your data.

npx agentmarket install skill/x-mckay-safe-refactor

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

We use your email only for this newsletter. Privacy

About

Performs behavior-preserving refactors with a tight verify loop. Use when an agent restructures code without intending to change behavior.

Use cases: agent-building

Reviews

Write a review

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this skill can do and what it asks for, from its SKILL.md. Checked Oct 25, 2026.

Tools
No tools found
Secrets
None asked for
Install scripts
None found

Network hosts it talks to 1

  • codeload.github.com · found in install command

Files it touches

  • ~/.claude/skills/safe-refactor

What's inside

Skill name
safe-refactor
Description
Performs behavior-preserving refactors with a tight verify loop. Use when an agent restructures code without intending to change behavior.
License
Apache-2.0
Instructions
17 lines in SKILL.md · view on GitHub

Files (1)

  • SKILL.md

SKILL.md (first lines)

# Safe Refactor

Refactors must not change observable behavior.

1. Establish a green baseline: run the relevant tests before touching anything.
   If they are red, stop and report — do not refactor on a broken base.
2. Make one small, mechanical change at a time (rename, extract, inline). Keep
   each step independently revertible.
3. Re-run the targeted tests after each step. If a step goes red, revert it.
4. Treat the objective as the compatibility boundary. Remove obsolete APIs
   when the objective calls for a clean break; otherwise keep public behavior
   stable. If `avoidPublicApiChanges` is set, treat exported symbols as frozen.
5. Keep the diff minimal and reviewable; do not reformat unrelated code.

Report the before/after test status and the list of mechanical steps taken.

From X-McKay/bakudo, Apache-2.0.

More from X-McKay/bakudo

Signals

Stars
0
Forks
0
Open issues
10
Last commit (this folder)
Aug 17, 2026 (2 months ago)

From GitHub (fetched Oct 24, 2026).

Details

License
Apache-2.0
Repository
github.com/X-McKay/bakudo
First seen
Oct 24, 2026
Last checked
Oct 24, 2026
Source
GitHubgithub-graphql

More from X-McKay

Cite this page

safe-refactor skill. Agent Mart. https://agentmart.dev/skills/x-mckay-safe-refactor (last updated 2026-10-24)