heathen
Installation
SKILL.md
Heathen
No gods, no god files. Find oversized or duplicated code, then split it in a safe order. Prefer evidence over instinct: measure candidates, read the worst files, identify actual responsibilities, and refactor one behavioral boundary at a time.
State at the start that you are using the heathen skill.
Core Rule
Do not split files just because they are long. Split when the file has multiple responsibilities, duplicated logic, unstable change reasons, hard-to-test branches, or a public interface that can be made smaller.
Workflow
-
Run the scanner (paths below are relative to this skill's directory):
python3 scripts/find-god-files.py /path/to/repoUse
--jsonwhen another tool or script will consume the report. Use--include-testswhen the user asks about duplicated test logic or test-suite cleanup.