Agent skill
refactoring-codebase
Guidelines for maintaining a clean codebase through limits and abstraction. Use when a file or component becomes difficult to read.
Stars
163
Forks
31
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/refactoring-codebase
SKILL.md
Refactoring and Code Cleanup
When to use this skill
- A component file exceeds 200 lines.
- The same logic is repeated in 3 or more places.
- Props are becoming too many/complex.
Rules
- The "Boy Scout Rule": Always leave the code slightly cleaner than you found it.
- Sub-components: Split large components into smaller files in a local
components/subfolder. - Custom Hooks: Extract stateful logic (complex forms, complex filters) into hooks.
Workflow
- Identify a "Messy" component.
- Extract presentational parts into atomic components.
- Extract logic into Services or Hooks.
- Verify that the visual UI has NOT changed.
Instructions
- No Pre-optimization: Refactor logic only when it's actually reused or the file is unmanageable.
Didn't find tool you were looking for?