# Repo Audit

> Repo Audit

- Skill: `trac3r00/repo-audit` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add trac3r00/repo-audit`
- Raw SKILL.md: https://api.skillmd.com/api/skills/trac3r00/repo-audit/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Security
- Author: trac3r00 (https://skillmd.com/u/trac3r00)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/trac3r00/repo-audit

---


# Repo Audit

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

## Commands

```bash
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).