▲ RepoGrade

Grade your repo before you announce it. 33 checks across 6 categories on any public GitHub repository — in one command, in ~15 seconds, with zero dependencies.

Part of FastPress Labs — small, free, open source tools for people who ship. Sister project: LaunchGrade audits the landing page; RepoGrade audits everything behind the link.

Install

npx -p github:fastpresspages/repograde repograde owner/repo

An npm publish is planned once publishing credentials exist; the GitHub install path above works today with zero install footprint.

repograde owner/repo          # grade any public repo
repograde owner/repo -o report   # + report.html/json/md, badge.svg, fix-plan.md
repograde --list              # all 33 checks, grouped
repograde --fail-under 80 owner/repo   # CI gate (exit 2 when under)

What it grades

Every check is a pure function over the shaped repo context (see src/checks.js) — the whole scan is deterministic and fixable in PR-sized chunks.

Real example (not marketing)

fastpresspages/launchgrade scanned on 24 October 2026 (v0.1.0):

┌──────────────────────────────────────────────┐
│  A+   96/100   Announce-ready                │
└──────────────────────────────────────────────┘
  28 pass · 3 warn · 0 fail

  Documentation     100  ████████████████████
  Community         100  ████████████████████
  Engineering        96  ███████████████████░
  Discoverability   100  ████████████████████
  Release hygiene    85  █████████████████░░░
  Agent-readiness    90  ██████████████████░░

Fix these first
 1. WARN [Release] Tag matches package.json
      package.json 0.3.0 vs release tag v0.1.0
 2. WARN [Agent] llms.txt published
      No llms.txt at the repo root
 3. WARN [Eng] Dependencies pinned
      No lockfile ...

Full artifacts for that scan and a lower-grade example live in samples/ (launchgrade → A+ 96, fastpress-start → B 79, same day, honest numbers). Low grades get published too — that is the point.

The RepoGrade site itself is audited by LaunchGrade: A+ 100/100 at launch (24 Oct 2026, samples/repograde-site/, one intentional no-analytics warning).

Reports & artifacts

GitHub Action

name: RepoGrade
on:
  schedule: [{ cron: "0 8 * * 1" }]
  workflow_dispatch:
jobs:
  grade:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v7
      - uses: fastpresspages/repograde@main
        with:
          fail-under: '75'
        env:
          GITHUB_TOKEN: ${{ github.token }}   # 5,000 req/h instead of 60

Outputs score and grade; add --fail-under semantics via fail-under.

MCP server (agents can grade repos too)

{ "mcpServers": { "repograde": {
    "command": "npx",
    "args": ["-p", "github:fastpresspages/repograde", "repograde-mcp"] } } }

Tools: grade_repo (owner/repo → grade + category scores + fixes), list_checks.

MCP check-only rule for agents: batch sanely; the unauthenticated GitHub API allows 60 requests/hour and we respect that limit.

Agent skill

npx skills add fastpresspages/repograde

Scoring

• Each category score = share of its weight earned (pass=100%, warn=50%, fail=0%).
• Overall = weighted mean over scored categories; skip/info checks leave the pool.
• Letter grades: A+ ≥95 · A ≥90 · A- ≥85 · B+ ≥80 … F <40.
• It is an heuristic about readiness to be announced, not a security audit and not a code review (see SECURITY.md and terms).

Free human review

Open a discussion with your repo + what you are stuck on, drop your repo at the site form, or email meetcode99@gmail.com: we rerun the scan, read the repo and reply with the three changes that matter most — free, no drip campaign. Deeper help (fix sprints, launch builds) exists and is transparently priced in the FastPress Labs playbook.

Principles

1. Zero dependencies — Node stdlib only.
2. Public data only — never writes to your repo, never uploads anything.
3. Publish low grades too.
4. Fix text a tired human can act on.
5. No fake metrics: downloads, stars, testimonials — all hand-countable or absent.

Contributing / security / license

• CONTRIBUTING.md (check contract, PRs)
• SECURITY.md (private disclosure)
• SUPPORT.md · Code of Conduct
• Apache-2.0 — see LICENSE

Built by FastPress Labs — see our org profile for everything we ship.