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?

Be as detailed as possible for better results