Comparison · both free
README Doctor vs Roast My GitHub
The short answer
README Doctor rewrites the file so a stranger can install and run the project. Roast My GitHub looks at the whole public profile, makes the joke, and ends with one fix, often that missing README. Start with the roast to choose the fix. Start with README Doctor when you already know the README is the job.
README Doctor
Paste a README. Get a rewrite a new contributor can follow: install, run, test, and the command that proves it worked.
- You paste
- Paste the README and the scripts. Copy the README. If package.json, pyproject, or a Makefile lists scripts, paste those names too. Do not paste secrets from a real .env.
- You get
- The proof. The command to prove it is npm test, because that script exists. Slack is not a setup step.
- When to use it
- Use it when your README welcomes people to the project and never says the command that makes it run on a clean machine.
- When to skip it
- It does not run your code. If your install steps are wrong, it can only flag what looks missing, not test it.
- Runs in
- Cursor, Claude, ChatGPT
- Difficulty
- Easy
- Shelf
- Dev Tools
Roast My GitHub
Hand it a GitHub profile and get a sharp, affectionate roast of the work, plus one fix worth doing this week.
- You paste
- Pick the account. Use your own login, or any public account. Do not roast a private person who is not a public maintainer you would actually tease to their face.
- You get
- One serious fix. This week: write a four-line README on ai-saas-boilerplate that says what it is, who it is for, and how to run it. Pin that. Archive the todo app.
- When to use it
- Use it when you want an honest laugh at your GitHub profile and one fix you will actually make this week.
- When to skip it
- It roasts the work, not the person. It will not mock someone else's profile without their say-so.
- Runs in
- ChatGPT, Claude, Gemini
- Difficulty
- Easy
- Shelf
- Fun & Weird
Questions
What is the difference between README Doctor and Roast My GitHub?
README Doctor rewrites the file so a stranger can install and run the project. Roast My GitHub looks at the whole public profile, makes the joke, and ends with one fix, often that missing README. Start with the roast to choose the fix. Start with README Doctor when you already know the README is the job.
Are README Doctor and Roast My GitHub free?
Yes. Both are free prompts from One Agent a Day under CC BY 4.0. README Doctor runs in Cursor, Claude, ChatGPT. Roast My GitHub runs in ChatGPT, Claude, Gemini.
All comparisons · Find an agent by task
Friday email
The week’s 7 agents, in one email
Every Friday. Seven free prompts, one tip, one “paste this first.” Unsubscribe anytime.
A recent week: Catch Me Up, Flake Hunter, Trip Cost Splitter.
The daily agent stays free. Pro waitlist is a separate list, and it is not open yet.