Repo Audit

Repo Audit

trac3r00 Updated

File contents

Repo Audit

"Is this thing maintained?" in one deterministic pass.

Commands

python3 scripts/repo_audit.py .                 # this repo
python3 scripts/repo_audit.py ~/src --json      # any repo
python3 scripts/repo_audit.py . --stale-days 60
python3 scripts/repo_audit.py . --fail-on license,tests
for d in ~/src/*/; do python3 scripts/repo_audit.py "$d" --json; done

Checks

Check Fail when
license no LICENSE file
readme no README
tests no test files detected
ci no CI config (GitHub Actions, GitLab CI, CircleCI)
gitignore missing (untracked junk risk)
large_files tracked files over 5MB (warn)
stale_branches merged branches idle > --stale-days (warn)

--fail-on a,b requires specific checks — the rest become advisory.

Pairs with

git-master (act on the stale branches this finds), skill-audit (the same structural-hygiene idea, for agent skills), diff-review (the per-change gate; this is the per-repo gate).

trac3r00/agent-skills/tree/main/skills/repo-audit commit 2dfb90b1f7

Frequently asked questions

npx skillmds@latest add trac3r00/repo-audit