eng-code-cleanup
Installation
SKILL.md
Code Cleanup
Structural cleanup, code-level cleanup, and refactoring — without breaking functionality.
Golden Rules
- Preserve behavior — Every change must produce the same observable behavior. If you can't verify this, don't make the change.
- Small incremental steps — One change at a time. Commit between steps. Never combine a refactor with a feature change.
- Check existing conventions first — Before changing anything, read the codebase's existing coding guidelines, linting config, naming patterns, and file structure. Match them.
- Test after each change — Run the test suite after every modification. If tests break, revert and try a smaller step.
- Rollback awareness — Commit before starting. Note the hash. If a change chain gets too complex,
git reset --hard <hash>and try a different approach.
Triage
Determine scope before starting. These parts can be used independently or combined.