What is readme-roast?

README-ROAST is a skill for Claude Code that reads a project's README file and rewrites it as a brutally honest version, pointing out exaggerations, missing information, and gaps between what a README claims and what the project actually delivers. It works on your current project folder or on a remote GitHub repository given as a URL. The roast comes in one of eight personas, such as an angry chef, a nature documentary narrator, a noir detective, or a Gen Z hype poster, each with its own voice and jokes, chosen randomly unless you pick one with a flag. Every run also produces a serious side: a Honesty Score out of 100, a report card grading things like buzzword use, whether the installation instructions actually work, and how many people maintain the project, plus a shareable one line summary and a badge you can add to your real README. Under the humor, the tool checks real, specific things: how many vague marketing words like modern or blazing fast appear, whether claimed features actually exist in the code, whether the setup steps work as written, whether a license is present, and whether the documentation matches the project's true state. It also lists a few concrete, quick fixes the author can make right away. The project is upfront about its limits. It cannot run your code or your benchmarks, it cannot deeply verify a remote repository beyond its README and public stats, and it does not replace a human reviewer or a code linter. Installing it is simple: clone or copy the files into your Claude Code skills folder, and the new command becomes available right away. It is released under the MIT license.