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

  1. Run the scanner (paths below are relative to this skill's directory):

    python3 scripts/find-god-files.py /path/to/repo
    

    Use --json when another tool or script will consume the report. Use --include-tests when the user asks about duplicated test logic or test-suite cleanup.

Installs
16
Repository
howells/skills
GitHub Stars
2
First Seen
May 21, 2026
heathen — howells/skills