# repo-audit

> GitHub repo launch-readiness checker. Audits 9 discoverability signals and returns a ranked punch-list.

## Summary

`repo-audit` takes a public GitHub URL and checks whether the repo is set up to be found — by GitHub search, PyPI, package registries, HN, Reddit, and awesome-* lists. Returns a score 0-100 with per-signal findings and concrete actions. Every claim cites a real source URL.

## Install

```bash
pip install repo-audit
```

## Fastest Usage

```bash
repo-audit github.com/owner/repo
repo-audit github.com/owner/repo --json
repo-audit github.com/owner/repo --verbose
```

## Python API

```python
from repo_audit.audit import run_audit
report = run_audit("github.com/owner/repo")
# report.overall_score: int 0-100
# report.grade: "A" | "B" | "C" | "D" | "F"
# report.top_actions: list[str]
# report.signals: list[SignalResult]
```

## Signals

README Quality, Repo Metadata, Social Proof, Release Cadence, Docs & Agent Files, Distribution (PyPI/npm), Web Discoverability, Topical Citations, Launch Channels.

## Limitations

- Public repos only (GitHub public API)
- No GitHub token required; unauthenticated limit 60 req/hr
- DDG signals may return empty on rate-limit; defaults to WARN not FAIL
- Distribution check uses repo name as PyPI/npm name (misses renamed packages)

## Source

https://github.com/roli-lpci/repo-audit
