KorroAi

Readme Roast — Documentation skill for Claude Code

Documentation community

README-ROAST — Your README is lying to you.

How to install Readme Roast

This entry records only its repository, not the path inside it, so there is no exact command to give. Open KorroAi/readme-roast and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Readme Roast does

README-ROAST — Your README is lying to you. A Claude Code skill that generates brutally honest alternate READMEs with 5 personas. Honesty Score, badges, CI integration.

Alternatives in Documentation

Onto Doc — Build the ENTIRE knowledge base for this repo — survey the codebase, then dispatch kb-curate curator agents pe 75 ★
Save To Md — Save session documentation with Neo4j memory integration 40 ★
Create Feature — Create a complete feature with tests, documentation, and proper integration 18 ★

README

🔥 README-ROAST

Your README is lying to you. Time for an intervention.

**README-ROAST** is a [Claude Code](https://claude.ai/code) skill that roasts your README. 8 personas. Honesty Score. One-liner. Badge. Fits in one screenshot. Equal parts savage and useful.

README-ROAST demo

Quick Start

# Install (Claude Code skill)
# Place in ~/.claude/skills/readme-roast/

# Then:
/readme-roast                              # Roast current directory (random persona)
/readme-roast github.com/vercel/next.js    # Roast a remote repo
/readme-roast --ramsay                     # Gordon Ramsay yells at your README
/readme-roast --self                       # The skill roasts itself. Flex.

8 Personas

You never know who's showing up.

Persona	Vibe	Signature
🍳 Gordon Ramsay	Chef rage	"Your install section is RAW."
🌿 David Attenborough	Nature doc	"Here we see the junior dev, puffing up its README..."
🕵️ The Detective	Noir PI	"The benchmarks folder was empty. Someone cleaned up."
🧊 The Ex	Toxic ex	"'Production-ready.' That's what you said about your last project."
👶 The Toddler	Asks why endlessly	"You said it's lightweight. Why? 847 deps. Why?"
🎤 Stand-Up Comedian	Netflix special	"'Synergistic.' [pause] In a TODO app."
🗿 The Brutalist	5 words max	"This paragraph serves no purpose."
🔥 The Hypebeast	Gen Z slang	"Your install steps? Mid. Feature list? Goated. fr fr.