Docs
Getting Started
PRs.md proves you actually read your own pull request. Paste a GitHub PR URL, answer three questions generated from the real diff, and earn a shareable verified badge.
Prerequisites
- A GitHub account — used for sign-in only (read:user scope)
- An API key from OpenAI, Anthropic, or Google Gemini
- A public GitHub pull request — private repos are not currently supported
PRs.md is bring-your-own-key. We never proxy your requests through our own credits — your key talks directly to the provider.
Step 1 — Sign in
Go to prs.md and click Sign in with GitHub. We request the minimal read:user and user:email scopes — no repo access, no write permissions.
Step 2 — Add your API key
Head to Dashboard → API Keys and paste in your key. Keys are encrypted at rest with AES-256-GCM before being written to the database. You can store one key per provider and swap them anytime.
Step 3 — Create your first challenge
Paste any public GitHub PR URL into the input on the Challenges tab and hit Generate. PRs.md fetches the diff, sends it to your chosen LLM, and returns three targeted questions — one of which is a hallucination trap.
The quiz is timed at three minutes. When the timer starts, copy-paste is disabled so your answers reflect what you actually know.
Step 4 — Earn your badge
Submit your answers and the LLM grades them. A passing score generates a permanent proof page at prs.md/proof/[id]containing your full Q&A. Drop the badge into your PR description — reviewers can click through to verify it's real.