improve

Originally fromwitooh/skills
Installation
SKILL.md

Improve

Make code easier to understand without changing what it does. Reduce the layers a reader must trace and the hidden state they must remember.

Process

  1. Identify the target from the request, current diff, or recently changed code.
  2. Read the target, its tests, and relevant surrounding code. State the behavior that must not change.
  3. If that behavior lacks tests, add focused coverage and run it against the unchanged code. Commit the passing test-only change before refactoring. If automated tests cannot exercise the behavior, explain why and give other evidence.
  4. Find unnecessary complexity, duplication, dead code, weak names, awkward boundaries, and abstractions that cost more than they help.
  5. Make focused improvements by deleting, deduplicating, renaming, simplifying, extracting, or inlining.
  6. Preserve public interfaces, data shapes, errors, and user-visible behavior unless the user explicitly asks to change them.
  7. Run tests and checks that cover behavior the refactor can affect. Report what improved, what behavior was preserved, and the evidence.

Return

State what became simpler, what behavior stayed the same, and which checks prove it. Name any behavior that remains unverified.

Boundaries

Installs
128
GitHub Stars
347
First Seen
Jul 19, 2026
improve — owainlewis/blueprint