README Score - Free Online README Grader Tool | IconVault
Paste your README.md and get it graded against 16 proven practices: badges, screenshots, install docs, usage, API, license. Free, runs 100% in your browser.
README Score
Grade your README against 16 proven practices
0 characters - everything stays in your browser.
5 of 5 free scans left.
Your score appears here
We check 16 practices used by the most-starred open-source projects, then tell you exactly what to add.
About this tool
IconVault's README Score grades your README against 16 proven practices that separate good project docs from great ones: a clear H1 title, a one-paragraph description, status badges, screenshots or a demo, install and usage sections, API reference, contributing guide, changelog, table of contents and a license, among others.
Paste your markdown and every check gets a pass or fail with a short, actionable tip explaining what to add or fix. It runs 100% in your browser, so your content is never uploaded, and it is free with no signup.
Frequently asked questions
Popular searches
More tools
Code Playground
Write HTML, CSS & JS with live preview.
JSON Formatter
Beautify, validate & minify JSON.
Base64 Encoder
Encode & decode text and files.
JWT Decoder
Inspect tokens without sending them anywhere.
Coming soon
CLI
Coming soon
Figma plugin
Coming soon
VS Code extension
Coming soon
Chrome extension
Coming soon
AI icon generator
Coming soon
Team workspaces
Coming soon