How do I install the Nw Refactor skill?

Run npx skillmds add majiayu000/nw-refactor in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Nw Refactor safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Nw Refactor?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Nw Refactor free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Nw Refactor?

majiayu000 (@majiayu000) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Nw Refactor by majiayu000 — Agent Skill

Name: Nw Refactor
Rating: 4.666666666666667 (3 reviews)
Author: majiayu000

File contents

NW-REFACTOR: Systematic Code Refactoring

Wave: CROSS_WAVE Agent: Crafty (nw-software-crafter) Command: *refactor

Overview

Applies the Refactoring Priority Premise (RPP) — cascading 6-level hierarchy where lower levels complete before higher. Levels: L1 Readability|L2 Complexity|L3 Responsibilities|L4 Abstractions|L5 Design Patterns|L6 SOLID++. Each builds on previous. For complex multi-class refactorings, agent applies Mikado Method internally.

Context Files Required

src/* - Production codebase
tests/* - Test codebase

Agent Invocation

@nw-software-crafter

Execute *refactor for {target-class-or-module}.

Context Files:

src/*
tests/*

Configuration:

level: 3 # Shorthand: --from=1 --to=3 (RPP range)
from: 1 # Start RPP level (default: 1)
to: 3 # End RPP level (default: same as level)
scope: module # file/module/project
method: extract # extract/inline/rename/move
mikado_planning: false # Use Mikado Method for complex refactorings

Success Criteria

Code quality metrics improved (measured before/after)
All tests passing after refactoring
Refactoring levels applied in sequence (L1 before L2, etc.)
Technical debt reduced measurably

Next Wave

Handoff To: {invoking-agent-returns-to-workflow} Deliverables: Refactored codebase with quality improvements

Examples

Example 1: Module-level readability refactor

/nw-refactor src/auth/token_manager.py --level=2 --scope=module

Crafty applies RPP L1-L2: rename ambiguous variables|extract magic numbers into constants|remove dead code (L1), then simplify conditionals|extract long methods (L2).

Example 2: SOLID-level design refactor

/nw-refactor src/billing/ --level=6 --scope=module --mikado_planning=true

Crafty uses Mikado Method for multi-class refactoring, applies dependency inversion|interface segregation across billing module.

Example 3: RPP range sweep (L1-L3)

/nw-refactor src/des/domain/ --from=1 --to=3 --scope=module

Sweeps L1 readability|L2 complexity|L3 responsibility smells. Cascade rule: L2 only after L1 clean, L3 only after L2 clean.

Example 4: Targeted single-level refactor

/nw-refactor src/des/cli/verify.py --level=3 --scope=file

Targets L3 responsibility smells only (Large Class, Feature Envy, Shotgun Surgery). Assumes L1-L2 already clean.

Expected Outputs

src/*                              (refactored production code)
tests/*                            (refactored test code)
docs/refactoring/
  refactoring-log.md
  quality-metrics.md

---name: nw-refactordescription: Applies the Refactoring Priority Premise (RPP) levels L1-L6 for systematic code refactoring. Use when improving code quality through structured refactoring passes.--- # NW-REFACTOR: Systematic Code Refactoring **Wave**: CROSS_WAVE **Agent**: Crafty (nw-software-crafter) **Command**: `*refactor` ## Overview Applies the Refactoring Priority Premise (RPP) — cascading 6-level hierarchy where lower levels complete before higher. Levels: L1 Readability|L2 Complexity|L3 Responsibilities|L4 Abstractions|L5 Design Patterns|L6 SOLID++. Each builds on previous. For complex multi-class refactorings, agent applies Mikado Method internally. ## Context Files Required - src/\* - Production codebase - tests/\* - Test codebase ## Agent Invocation @nw-software-crafter Execute \*refactor for {target-class-or-module}. **Context Files:** - src/\* - tests/\* **Configuration:** - level: 3 # Shorthand: --from=1 --to=3 (RPP range) - from: 1 # Start RPP level (default: 1) - to: 3 # End RPP level (default: same as level) - scope: module # file/module/project - method: extract # extract/inline/rename/move - mikado_planning: false # Use Mikado Method for complex refactorings ## Success Criteria - [ ] Code quality metrics improved (measured before/after) - [ ] All tests passing after refactoring - [ ] Refactoring levels applied in sequence (L1 before L2, etc.) - [ ] Technical debt reduced measurably ## Next Wave **Handoff To**: {invoking-agent-returns-to-workflow} **Deliverables**: Refactored codebase with quality improvements ## Examples ### Example 1: Module-level readability refactor ``` /nw-refactor src/auth/token_manager.py --level=2 --scope=module ``` Crafty applies RPP L1-L2: rename ambiguous variables|extract magic numbers into constants|remove dead code (L1), then simplify conditionals|extract long methods (L2). ### Example 2: SOLID-level design refactor ``` /nw-refactor src/billing/ --level=6 --scope=module --mikado_planning=true ``` Crafty uses Mikado Method for multi-class refactoring, applies dependency inversion|interface segregation across billing module. ### Example 3: RPP range sweep (L1-L3) ``` /nw-refactor src/des/domain/ --from=1 --to=3 --scope=module ``` Sweeps L1 readability|L2 complexity|L3 responsibility smells. Cascade rule: L2 only after L1 clean, L3 only after L2 clean. ### Example 4: Targeted single-level refactor ``` /nw-refactor src/des/cli/verify.py --level=3 --scope=file ``` Targets L3 responsibility smells only (Large Class, Feature Envy, Shotgun Surgery). Assumes L1-L2 already clean. ## Expected Outputs ``` src/* (refactored production code) tests/* (refactored test code) docs/refactoring/ refactoring-log.md quality-metrics.md ```

Frequently asked questions