Book Refactoring Pass

Guides behavior-preserving refactoring with small, reversible steps. In strict tasks, mandatory before the first implementation edit to existing production code; in default/lite tasks, use on demand when structural friction, duplication, long functions, tangled responsibilities, unsafe cleanup, or explicit delivery requirements affect the change.

559 stars 13 forksSoftware Development

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add KunoLu/640-skills --skill book-refactoring-pass
Manual install
git clone --depth 1 https://github.com/KunoLu/640-skills.git /tmp/640-skills
mkdir -p ~/.claude/skills
cp -r /tmp/640-skills/sbtd-workflow-onboard/templates/skills/book-refactoring-pass ~/.claude/skills/book-refactoring-pass

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Book Refactoring Pass

Use this Skill as a focused refactoring check before or during implementation.

It is derived from the `mini` rule style of `agent-rules-books`. It is a strict development gate for existing-production-code edits and an on-demand engineering lens in other structural-risk scenarios; it does not replace project rules, tests, task artifacts, source/LSP/contract impact analysis, or code review.

## Strict Development Gate

Whenever a strict task will modify existing production code, run this Skill before the first implementation edit to existing production code, even when the expected result is that no refactoring is needed.

Emit a separate visible review:

```text
Refactoring Review
Status: proceed | refactor-first | blocked
Review mode: normal | safety-seam-only
Existing-code scope: ...
Behavior that must remain unchanged: ...
Structural friction: ...
Decision and smallest safe step: ...
Safety net and validation: ...
Deferred refactors: ...
```

- `proceed`: in normal mode, the existing structure is safe enough for the requested edit; `no refactor needed` is a valid explicit conclusion.
- `refactor-first`: perform only the smallest behavior-preserving structural change allowed by the current review mode, validate it, and rerun the required gate before feature or fix edits.
- `blocked`: required behavior evidence, a safety net plan, or the Skill is unavailable; state the blocker and do not edit production behavior.
Read the full skill on GitHub

Details

Skill name
book-refactoring-pass
Path
sbtd-workflow-onboard/templates/skills/book-refactoring-pass/SKILL.md
License
Apache-2.0
Repo updated
13 November 2026

FAQ

What does the Book Refactoring Pass skill do?

Guides behavior-preserving refactoring with small, reversible steps. In strict tasks, mandatory before the first implementation edit to existing production code; in default/lite tasks, use on demand when structural friction, duplication, long functions, tangled responsibilities, unsafe cleanup, or explicit delivery requirements affect the change.

How do I install the Book Refactoring Pass skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add KunoLu/640-skills --skill book-refactoring-pass. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Book Refactoring Pass popular?

It lives in KunoLu/640-skills, which has 559 GitHub stars and 13 forks.

Related skills

Handoff

559

KunoLu/640-skills

Compact the current conversation into a handoff document for another agent to pick up.

AI, LLMs & AgentsIn 2 lists13

Codebase Design

559

KunoLu/640-skills

Shared vocabulary for designing deep modules. Use when the user wants to design or improve a module's interface, find deepening opportunities, decide where a seam goes, make code more testable or AI-navigable, or when another skill needs the deep-module vocabulary.

Software DevelopmentIn 2 lists13

Diagnosing Bugs

559

KunoLu/640-skills

Diagnosis loop for hard bugs and performance regressions. Use when the user says "diagnose"/"debug this", or reports something broken/throwing/failing/slow.

Software DevelopmentIn 2 lists13

Ponytail Audit

559

KunoLu/640-skills

Quality audit of a whole repo: bugs, security holes, what breaks under real load, risky code without tests, slow paths, and what to delete, merge or split. Ranked, each finding explained in plain English. One-shot report, changes nothing. Use for "audit this codebase", "review the whole repo", "find bloat", "what can I delete", /ponytail-audit.

Software Development13

Script Evaluator

514

VanGong1999/screen-creative-skills

Evaluate film and TV scripts across ideological, artistic, and entertainment value dimensions, producing structured scoring reports with follow-up recommendations. Use when assessing script development quality, determining modification direction, reviewing scripts before project approval, or benchmarking screenwriter capabilities.

Software Development86

Ponytail Review

559

KunoLu/640-skills

Quality review of a change: is the logic right, is it safe, does it hold under real load, is risky code tested, is it fast enough, and is every line needed. Reads the connected code, not only the diff. Each finding is explained in plain English. Use for "review this", "code review", "review the last commit", "review my PR", "is this over-engineered", /ponytail-review.

Software Development13

Browse the most popular Claude skills, all software development skills, or write your own with the skills generator.