Developer Quality · Readiness before publication
Public Repo Audit
Review documentation, licensing, packaging, tests, CI and basic safety hygiene before releasing a repository.
PythonGitHubCLIWhy it matters
The problem
A repository may be functional but still miss documentation, CI, licensing or other public-readiness signals.
How it works
The approach
A deterministic, local-only audit checks repository evidence and reports a score, blockers, warnings and recommendations.
What it includes
- README, license and packaging checks
- CI and tests readiness checks
- Deterministic score and verdict
- Markdown and JSON reports
Try the tool
Quick start
Commands adapted from the project's documented README. Run from the repository root after cloning it; consult the full README for prerequisites and platform-specific setup.
git clone https://github.com/migmcc/public-repo-audit.git
cd public-repo-audit
python -m venv .venv
.\.venv\Scripts\python -m pip install -e .
.\.venv\Scripts\public-repo-audit .Scope and trust
Important limitations
Not a full security audit and not a replacement for code review. Does not use the GitHub API or analyze social signals.