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.
Analysis is performed on our servers. We do not store or share your data.
Use cases

When to analyze a README

The README is the first and often only documentation anyone reads.

Before open sourcing

A public repository with no install or licence section costs contributors before it costs anything else.

Onboarding a new team member

Read the document the way someone without your context does, and find where they would stop.

Auditing many repositories

The same rule set applied to every repository gives a comparable score instead of an opinion.

Scope and limits

Rule-based, repeatable, local

The same text always produces the same score, and nothing is sent to a language model.

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

What a README score usually prompts.

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.