← ClaudeAtlas

maintainer-healthlisted

Audits an open-source repository's health and scores it out of 100: README sections, LICENSE, CONTRIBUTING, SECURITY, code of conduct, CI, tests, issue and PR templates, changelog, .gitignore and CODEOWNERS, plus live signals from GitHub such as response time and stale PRs. Outputs a scored checklist with the fixes ordered by impact. Use when the user says "how healthy is my repo", "audit my repo", "is my project ready for contributors", "repo checklist", "what is my repo missing", or "score my open source project".
vivekbhange-hub/maintainer-skill · ★ 0 · AI & Automation · score 75
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