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.
Install
npx skills add KunoLu/640-skills --skill book-refactoring-passgit 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-passPersonal 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.
Details
- Skill name
book-refactoring-pass- Repository
- KunoLu/640-skills
- 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
559KunoLu/640-skills
Compact the current conversation into a handoff document for another agent to pick up.
Codebase Design
559KunoLu/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.
Diagnosing Bugs
559KunoLu/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.
Ponytail Audit
559KunoLu/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.
Script Evaluator
514VanGong1999/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.
Ponytail Review
559KunoLu/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.
Browse the most popular Claude skills, all software development skills, or write your own with the skills generator.