aspiers/ai-config / .agents/skills/code-refactoring-small
code-refactoring-small
VerifiedRefactor code units whose size or mixed responsibilities impede understanding, testing, or change. Use when recent work makes a function, class, or module materially harder to reason about.
Refactoring Large Code Units
Improve cohesion and readability rather than optimizing for an arbitrary line count.
Workflow
- Read the whole unit and its important callers or tests.
- Identify the concrete source of difficulty: mixed responsibilities, deep nesting, hidden state transitions, repeated setup, or an unstable boundary.
- Choose extractions that have meaningful names and inputs. Follow existing repository structure rather than introducing layers solely to make units shorter.
- Preserve behavior and public contracts unless the task explicitly changes them.
- Verify with focused tests and the repository's normal quality gates.
A long linear function may be clearer than many tiny helpers; a short function may still combine unrelated responsibilities. Use size as a prompt to inspect, not a pass/fail threshold.
Keep the refactor scoped to what improves the current change. If a larger architectural split is justified, explain the trade-off and seek agreement before expanding scope.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 318k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 318k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 318k | Updated | Claude CodeCodex | Verified | Install |
| skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |