README Score
Your README, scored out of 100, with a fix for every miss
FreeOpen Source6 impressionslaunches Oct 281 comment
Maker links to DevHunt
Comments
>log in to commentHey everyone 👋 I'm the maker of README Score. Enter a GitHub repo or paste a README and get a score out of 100, the sections found and missing, and a fix for each miss. There's no AI in the scoring, so the same README always gets the same score. It's free with no signup. Tell me which check you'd want added next.
More Open Source tools →74 free dev tools →
README Score evaluates a GitHub README and gives a 0-100 score with specific fixes for missing sections.
- for
- Open-source maintainers and developers who want better READMEs.
- pricing
- free
- license
- MIT
Key features
- Score out of 100 — Calculates a total score based on seven weighted groups.
- Section detection — Identifies present and missing README sections for the project type.
- First-screen check — Evaluates title, install command, image, badges and short pitch.
- Readability analysis — Uses Flesch reading ease to score prose clarity.
- Quickstart verification — Ensures a single, clear quick-start block with commands.
- Link validation — Checks that relative links and anchors resolve correctly.
Use cases
- Get a quick quality score for a new open-source project's README
- Identify missing sections before releasing a library
- Generate concrete fix suggestions for each issue
- Compare README quality across multiple repositories
README Score vs alternatives
 README Score |  Polar |  Coolify |  Mastra | ||
|---|---|---|---|---|---|
| Best for | README quality scoring without AI | Static site generation for docs | Open-source billing | Self-hosted Heroku alternative | AI agent development |
| Pricing | Free | Free | Subscription | Free | Free |
| DevHunt upvotes | 1 | 0 | 0 | 0 | 0 |
| Launched | Oct 2031 | — | — | — | — |
- README Score vs Docusaurus: Docusaurus generates documentation sites; README Score only evaluates existing README content.
- README Score vs Polar: Polar handles payments and billing, while README Score focuses on README quality.
- README Score vs Coolify: Coolify provides self-hosted app deployment, not README analysis.
- README Score vs Mastra: Mastra is a TypeScript AI-agent framework; README Score is a static README grader.
README Score FAQ
How does README Score work without AI?+
It uses fixed synonym lists and rule-based checks, so the same README always receives the same score.
Do I need to create an account?+
No, the tool is free and requires no signup.
Can I score a README that isn’t in a GitHub repo?+
Yes, you can paste the raw README text directly.
What project types are supported?+
Four types are supported: CLI tool, library, full-stack app, and backend API, each with its own weighting.
What does the “Fix first, line undefined” message mean?+
It suggests adding a screenshot, GIF, or diagram within the first 20 lines of the README.
Summarized by DevHunt from readme.flisk.si · Nov 7, 2026. Details may change; check the official site.
