repo-hygienelisted

# Repo Hygiene Skill Detect (and optionally fix) systemic repository hygiene debt. The detection core is a plain, dependency-free bash script — the skill is a thin wrapper around it. The script is **report-only**: it never modifies anything. All mutation lives in this skill's fix mode and only runs when the user explicitly asks for it. ## Step 1: Run the Audit (Always Report First) Run the core script against the target repo (argument, or the current repo if none given): ```bash ~/.claude/skills/repo-hygiene/scripts/repo_hygiene.sh [repo-path] ``` Exit codes: `0` clean, `1` findings, `2` usage error / not a git repo. Add `--json` for machine-readable output. Add `--file-beads` to file beads for remaining findings after the fix pass. Run this first **even when the user asked for `--fix`** — fixes are always driven from a fresh report. ## Step 2: Present Findings Summarize each category with its severity, count, and a few example paths. Categories: | Category | Severity | Meaning | |----------|----------|---------| | `tracked-build-artifacts` | high | `target/`, `node_modules/`, `dist/`, `build/`, `__pycache__/`, `*.pyc`, `.DS_Store` under version control | | `large-tracked-files` | high | tracked blobs > 5 MB | | `dead-ci-workflows` | medium | tracked `.github/workflows/*.yml\|yaml` (GH Actions are disabled estate-wide — CI is Argo Workflows) | | `readme-dead-ci-badges` | medium | GitHub Actions badge URLs in the README (dead by policy) | | `readme-version-drift` | lo