Skip to content

README badge

Show your score in your README

Pin an analysis, open a pull request or copy the Markdown, and readers click through to the full report.

A quality signal anyone can check

  • Seen at first glance

    Readers, collaborators and reviewers see your score where they start: the README.

  • One click to the evidence

    The badge opens the full report, with the findings behind the score.

  • Stays current

    After improvements, re-pin a newer analysis; the link in your README stays the same.

Add it in three steps

  1. 01

    Analyze your repository

    From GitHub or a zip upload, in the web app or your coding agent.

  2. 02

    Pin an analysis

    Choose which analysis the badge shows; its report becomes public.

  3. 03

    Add it to your README

    With the GitHub App, RepoReady opens a pull request; or copy the Markdown.

How the badge works

The color follows the score

Each badge shows the score of the pinned analysis in the color of its category.

How the score works

Get your first score

New accounts get 3 free analyses. Pin one and the badge is live.