Skip to content

aspiers/ai-config / .agents/skills/code-refactoring-small

code-refactoring-small

Verified

Refactor 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.

FileKindSize
SKILL.mdskill md1.2 KB
---
name: code-refactoring-small
description: Refactor 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

1. Read the whole unit and its important callers or tests.
2. Identify the concrete source of difficulty: mixed responsibilities, deep
   nesting, hidden state transitions, repeated setup, or an unstable boundary.
3. Choose extractions that have meaningful names and inputs. Follow existing
   repository structure rather than introducing layers solely to make units
   shorter.
4. Preserve behavior and public contracts unless the task explicitly changes
   them.
5. 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.
finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 322kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 322kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 322kUpdated Claude CodeCodexVerifiedInstall
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: 198kUpdated Claude CodeCodexVerifiedInstall