Your GitHub repo is your strongest marketing piece.
The code is 90% of the work. RepoGrade handles the rest: docs, tests, CI, and contributor experience, scored against 13 deterministic checks with a specific list of what to fix.
github.com / your-project
0
/ 100
No screenshots or images in README (−20 pts)
No live demo link in README (−20 pts)
License file detected: MIT
Example only. Grade your own repository above.
Example inspection
Click any check to see the evidence pattern, the weight it carries, and the exact fix the scanner recommends. Every value here comes from the real rubric.
Verdict
A score from 0 to 100 reflecting the check's contribution weight.
Evidence
The exact files, fields, and signals the scanner looked for.
Recommended fix
A specific, actionable instruction, not a category note or vague suggestion.
Example inspection
Evidence
Recommended fix
Add a GIF, screenshot, or logo image. It is the fastest way to show what your project does.
How RepoGrade scores a repository
Thirteen checks across three categories. The same checks, the same weights, every single time.
Documentation
- README12
- Install and run9
- License6
- Contributing guide5
Engineering
- Tests18
- CI/CD14
- Reproducibility6
- Issue templates6
- Linting5
Project health
- Dependency manifest6
- Repository metadata5
- Activity5
- Housekeeping3
What each grade means
Grades map directly to score ranges. The cutoffs are fixed and never adjusted.
- A90–100Exemplary. Documentation, tests, CI, and contributor experience are all solid. This repo makes a strong first impression.
- B80–89Strong. The essentials are covered. A few targeted fixes would make this portfolio-ready.
- C70–79Good. Core signals are present but contributors will hit some friction. Worth addressing the top findings.
- D60–69Needs work. Key checks like tests or CI are weak or missing. The repo communicates less confidence than the code deserves.
- F0–59Not ready. Several critical criteria are absent. Start with the top findings in the report.
Set it up once, graded on every push
The free GitHub App rescans your repo on every push and pull request and posts the grade as a commit check. Your repo stays portfolio-ready as it changes, not just the day you graded it.
Grade any public repository.
No account required. Results in seconds.