safe-refactor

safe-refactor is a skill for Claude Code from ezBuilder/code-brain. It costs 20 tokens per session (363 once invoked), scanned A, original, Apache-2.0.

A small-step refactoring workflow that keeps existing behavior unchanged. Refactoring means improving code structure without intentionally changing what the software does.

In plain words
What is it for?
Locking behavior with regression tests, checking verification commands, removing unnecessary complexity, using existing standard or platform features, marking known simplification limits, and comparing results after the refactor.
Why use it?
It requires a passing behavior baseline before editing and stops when a change would alter behavior, reducing the risk of accidental feature or API changes.

Skill for Claude Code

Written for Claude Code: installed under .claude/.

Good fit Locking behavior with regression tests, checking verification commands, removing unnecessary complexity, using existing standard or platform features, marking known simplification limits, and comparing results after the refactor.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/ezbuilder/code-brain/safe-refactor
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add ezBuilder/code-brain --skill safe-refactor
Clone the repo
git clone --depth 1 https://github.com/ezBuilder/code-brain

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for safe-refactor

README.md
[![agentmods](https://agentmods.dev/badge/skills/ezbuilder/code-brain/safe-refactor/github.svg)](https://agentmods.dev/skills/ezbuilder/code-brain/safe-refactor)
Your own site
<a href="https://agentmods.dev/skills/ezbuilder/code-brain/safe-refactor"><img src="https://agentmods.dev/badge/skills/ezbuilder/code-brain/safe-refactor/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for safe-refactor

Your own site · 80×15
<a href="https://agentmods.dev/skills/ezbuilder/code-brain/safe-refactor"><img src="https://agentmods.dev/badge/skills/ezbuilder/code-brain/safe-refactor.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 20 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 363 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00020 $0.00363
Opus 5.5 $0.00008 $0.00145
Sonnet 5.5 $0.00004 $0.00073
Haiku 4.5 $0.00002 $0.00036

Measured 1mo ago against content hash be52673141e3, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

safe-refactor scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 1mo ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

kits/global-agent-kit/.claude/skills/safe-refactor/SKILL.md · 29 lines

What it actually says

리팩터링 절차:

  1. 리팩터링 목표와 비목표를 명시한다.
  2. 변경 전 검증 명령을 확인한다.
  3. behavior-lock: 편집 전에 동작을 고정하는 회귀 테스트가 GREEN인지 먼저 확인한다. 커버리지가 없으면 최소 회귀 테스트를 먼저 추가하고, GREEN 베이스라인을 만들 수 없으면 중단·보고한다.
  4. public behavior가 바뀌지 않도록 범위를 제한한다.
  5. 삭제, 표준/플랫폼 기능, 이미 설치된 의존성, 한 줄 축약을 먼저 찾는다.
  6. 가장 안전한 변경부터 위험한 순으로 진행한다.
  7. 변경 후 동일 검증을 실행해 baseline과 동일한지 확인한다.
  8. 포맷팅만 바뀐 diff가 생기면 되돌릴 방법을 먼저 찾는다.
  9. 알려진 한계를 남기는 축약은 cb-simplify: <ceiling>; revisit when <trigger>로 표시한다.
  10. 동작 변경이 발견되면 중단하고 보고한다.

금지:

  • 기능 변경
  • 스키마/API 변경
  • 새 dependency 추가
  • 단일 구현 abstraction/factory/wrapper 생성
  • 요청 없는 boilerplate/scaffold 추가
  • 테스트 약화
  • 포맷팅 대량 diff
  • 확신이 없을 때 추측(GUESS)으로 변경 — 모르면 그 부분은 SKIP하고 보고한다
  • 같은 파일에서 3회 시도 실패 시 강행 — revert 후 중단·보고한다
Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 1mo ago First seen · 29 lines · 20 tokens per session scan A be52673141e3

Subscribe to this mod's changes

safe-refactor is a skill published in the GitHub repository ezBuilder/code-brain (11 stars, last pushed 1mo ago), licensed Apache-2.0. It adds 20 tokens to every session and 363 once invoked, about $0.0001 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

vibhishana-niti

Activate Vibhishana Niti — a severe senior-engineer discipline for shipping the minimum correct change. Use when the user asks for the smallest/simplest fix, a minimal diff, root-cause (not symptom) fixes, when a request seems larger than needed, or when they say "vibhishana niti". Deactivate when they say "normal…

beingmartinbmc/jambavan · 82 tokens

root-cause-debugger

Use when investigating a bug, test failure, or unexpected behavior — before proposing any fix. Enforces observe/compare/hypothesize/fix phases to prevent guess-and-check thrashing. Escalates after 3+ failed fix attempts.

beingmartinbmc/jambavan · 55 tokens

jarvis-issues

Report bugs and request features for the jarvis MCP server via GitHub issues. Use when jarvis errors, an index fails, a limitation bites, or to request an improvement.

jarvis-intelligence/jarvis-index · 41 tokens

jarvis-setup

Install and configure Homebrew jarvis, the local-first structural code intelligence with an always-on Tree-sitter syntax baseline. Use when onboarding, registering the MCP server, or indexing a repo for the first time.

jarvis-intelligence/jarvis-index · 47 tokens

pre-action-interceptors

Use when a tool error begins with "INTERCEPTOR:", a sent message was silently hedged or rewritten, or the user asks about active guards or blocked actions. Not for ordinary tool errors.

Bitterbot-AI/bitterbot-desktop · 44 tokens

ccc

This skill should be used when code search is needed (whether explicitly requested or as part of completing a task), when indexing the codebase after changes, or when the user asks about ccc, cocoindex-code, or the codebase index. Trigger phrases include 'search the codebase', 'find code related to', 'update the…

cocoindex-io/cocoindex-code · 80 tokens