nijaru/refactor
dot_claude/skills/refactor/SKILL.md
Use when improving existing code structure while preserving behavior; trigger on complex functions, deep nesting, duplication, unclear names, or technical debt that does not require changing the design.
development
Updated Apr 25, 2026
$ install --global
skillsauthnpx skillsauth add nijaru/dotfiles refactorInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 25, 2026, 9:13 AM68.1s1 file scanned
SKILL.md
- name:
- refactor
- description:
- Use when improving existing code structure while preserving behavior; trigger on complex functions, deep nesting, duplication, unclear names, or technical debt that does not require changing the design.
- allowed-tools:
- Bash, Read, Grep, Glob, Edit, Task
Refactor
Boundary
Refactoring changes the shape of existing code without changing external behavior. If the first implementation is complete but should be replaced with a cleaner second attempt, use second-pass. If the current design may be fundamentally wrong, use rewrite.
Mandates
- Preserve behavior unless the user explicitly asks for behavior changes.
- Identify the concrete smell before editing: duplication, unclear names, oversized function, excessive nesting, primitive obsession, dead code, or misplaced responsibility.
- Prefer deletion and simplification over new abstractions.
- Verify with existing tests or focused manual checks.
Standards
- Split functions over 40 lines when they mix responsibilities.
- Flatten nesting deeper than 3 levels with guard clauses or extracted helpers.
- Replace magic values with named constants only when the meaning is domain-specific.
- Rename for intent; never introduce
_new,_old,_v2, or compatibility shims. - Delete dead code and speculative generality immediately.
Output
State the behavior-preservation check, the main structural change, and the verification command/result. If no edit is warranted, say what made the current structure acceptable.
Anti-Rationalization
| Excuse | Reality | | :--- | :--- | | "This is working, so structure does not matter." | Working code can still hide bugs and slow future changes. | | "I'll add a wrapper and migrate later." | Compatibility layers become permanent. Change the interface cleanly or do not change it. | | "This needs a rewrite." | If behavior and design stay the same, it is a refactor, not a rewrite. |
Related Skills
nijaru/second-pass
development
VerifiedTrustedCommunity
Use after completing a bug fix, feature, refactor, or tk task when the first implementation taught enough context to replace it with a simpler, cleaner, or more coherent version before finalizing.
SKILL.mdUpdated Apr 25, 2026
nijaru/zig-expert
development
VerifiedTrustedCommunity
Use when writing, migrating, or reviewing Zig code across recent stable versions (0.14-0.16), especially to correct stale syntax or stdlib, build.zig, allocator, formatting, or runtime API knowledge.
SKILL.mdUpdated Apr 22, 2026
nijaru/writer
documentation
VerifiedTrustedCommunity
Use when reviewing or revising text (prose, docs, commits) to remove AI patterns and improve voice/clarity.
SKILL.mdUpdated Apr 22, 2026
nijaru/twitter
content-media
VerifiedTrustedCommunity
Use when fetching X/Twitter post content by URL, or searching for recent X posts.
SKILL.mdUpdated Apr 22, 2026