maintainer-healthlisted
Install: claude install-skill vivekbhange-hub/maintainer-skill
# Repo health audit
A quick, honest checkup: what a newcomer, a security researcher, or a company evaluating the
dependency will look for, and what is missing. The file checks are scored by a deterministic
script so the number means the same thing every time; the GitHub activity checks add context
the files cannot show.
## Steps
1. **Locate the repo.** Use the path argument or the current directory. If the user gives
`owner/repo` and it is not cloned, ask before cloning; shallow-clone into a temp directory
(`gh repo clone owner/repo <tmp> -- --depth 1`) and say where it went.
2. **Score the files.**
```
python3 "${CLAUDE_SKILL_DIR}/health.py" <path> -o maintainer/health.md
python3 "${CLAUDE_SKILL_DIR}/health.py" <path> --format json
```
Points (100 total): README exists with substance 10, README sections (install 5, usage 5,
contributing 2, license 3), LICENSE 15, CONTRIBUTING 8, SECURITY 8, CI 10, tests 10,
changelog 6, issue templates 5, PR template 4, code of conduct 4, CODEOWNERS 3, .gitignore 2.
Grades: A 90+, B 75+, C 60+, D 40+, F below. Files are found case-insensitively in the
root, `.github/` and `docs/`. `--min-score N` exits 1 below N, useful in CI.
3. **Check quality, not just presence.** The script only knows a file exists. Read the ones it
found and note real problems in a "Quality notes" section:
- README install command that does not match the package name or manifest.
- CONTRIBUTING test command that differs fro