README Analyzer - score your project README | POLPROG Skip to content

README Analyzer BETA

Analyze your README for structure, completeness and best practices. Paste Markdown or point us at a repository.

Free to use No registration Privacy-first
Paste your README Markdown or point us at a GitHub repository.
Scope and limits

Rule-based, repeatable, local

Heuristics you can predict

Sections are detected from headings and well-known cues; the score is a fixed weighting of those sections plus a handful of structure checks. Links are counted, never requested, so this tool never claims a link is broken or alive. Nothing is analyzed by a third-party AI service, and no repository content is retained after the report is built.

Help

FAQ

My README is good but scores low. How?

The score rewards a predictable structure, because that is what a stranger navigates by. A brilliant document with no installation heading still costs a newcomer time, and that is what the missing section reports.

Are the links checked?

No. They are counted so the structure checks can see whether the document links out at all. Nothing is requested, so nothing here says a link works or is broken.

Is my code or README sent to an AI service?

No. The analysis is a deterministic parser on our own server. The text is read, scored and discarded.

Can I analyze a private repository?

Not by URL, since the fetch is unauthenticated. Paste the Markdown instead: it is processed in exactly the same way.

Want polished docs and developer experience?

We help teams ship clear documentation and better digital products.

Get in touch