roast-my-code

Review codebases for quality defects and improvement opportunities.

10|1|Updated Mar 19, 2026
One-click install
npx skills add https://github.com/reidemeister94/development-skills --skill roast-my-code
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: roast-my-code
Source: https://github.com/reidemeister94/development-skills/tree/main/skills/roast-my-code
Command: npx skills add https://github.com/reidemeister94/development-skills --skill roast-my-code

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Brutal, no-nonsense code reviews that reveal quality issues, anti-patterns, and AI-readiness gaps to help teams improve code health and deployment readiness.

Core Features & Use Cases

  • Self-run staff-review that delivers a ruthless critique of code quality, architecture, and testability.
  • AI-readiness audit to evaluate compatibility with AI-assisted tooling and deployment pipelines.
  • Optional --fix mode to auto-fix CRITICAL and HIGH issues via the core-dev workflow.

Quick Start

Tell me which directory or file to roast and I'll begin with a blunt, prioritized findings list.

Frequently Asked Questions about roast-my-code

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run an automated code review for quality and AI-readiness?

An automated code review audits a specified directory or file to reveal maintainability and testability defects. It evaluates compatibility with AI-assisted tooling and deployment pipelines to deliver a prioritized findings list.

What is an AI-readiness audit for a codebase?

An AI-readiness audit evaluates a codebase for compatibility with AI-assisted tooling and deployment pipelines. It identifies anti-patterns and quality issues that hinder automated workflows, producing a prioritized critique of code health.

Can I automatically fix critical code defects found during a code roast?

You can automatically fix critical and high-priority defects by enabling the optional fix mode. This routes identified issues through the core-dev workflow to return actionable recommendations and resolve code health problems.

Does this code review workflow support multiple programming languages?

The code review workflow applies to codebases across multiple repositories and programming languages. It uniformly analyzes architecture and testability to reveal quality defects and improvement opportunities regardless of language.

When should I use a ruthless code roast instead of a standard quality review?

Use a ruthless code roast when you need a brutal, no-nonsense critique to reveal deep anti-patterns and deployment readiness gaps. Standard reviews may lack the bluntness required to expose critical AI-readiness issues.