repo-onramp-check

Audits whether a public repo makes first proof, visible examples, and the rerun path obvious to a newcomer.

What it does

The first run is intentionally small: point the checker at a repo, inspect the score, and then decide whether the README, example, or verification path still needs work. That makes the next move obvious before the repo is shared more widely.

Try it locally

python3 repo_onramp_check.py .

Example output

Score: 5/5
README present: yes
Quick-start guidance: yes
Runnable example: yes
Sample data or examples: yes
Tests or verification path: yes

Where it helps

Use this before publishing a small tool, before recommending a starter repo internally, or before linking someone to a public repo as the anchor example for a broader pattern.