octocode-roast

Identify code quality and security sins with actionable fixes.

904|77|Updated Jun 5, 2025
One-click install
npx skills add https://github.com/bgauryy/octocode-mcp --skill octocode-roast
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: octocode-roast
Source: https://github.com/bgauryy/octocode-mcp/tree/main/packages/octocode-cli/skills/octocode-roast
Command: npx skills add https://github.com/bgauryy/octocode-mcp --skill octocode-roast

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides brutally honest code roasts with actionable fixes to surface quality and security issues, helping teams identify and remediate technical debt quickly.

Core Features & Use Cases

  • Immediate code quality feedback: Generate targeted roasts that highlight specific patterns (e.g., long functions, missing tests, security risks) and propose fixes.
  • Structured remediation plan: Output prioritized fixes with pragmatic steps and owner responsibilities.
  • Collaborative, multi-file analysis: Apply across single files or entire repositories, aggregating findings into a unified Hall of Shame that guides refactoring.

Quick Start

Use the roast skill on a target file or directory by instructing your AI to run the roast and return a prioritized list of sins with suggested fixes.

Frequently Asked Questions about octocode-roast

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

FAQPage Schema
How do I get a code review that identifies technical debt and security risks?

Static analysis roasts can detect design and quality sins by targeting individual files or whole repositories. They identify specific patterns like long functions, missing tests, and security risks, pairing each finding with actionable remediation steps.

What is a code roast and how does it help with software quality remediation?

A code roast is a brutally honest static analysis process that targets individual files or whole repositories to identify quality and security issues. It helps remediation by pairing detected design sins with prioritized, actionable fixes and owner responsibilities.

Can I run a code roast across an entire repository or only on single files?

You can run a code roast across both individual files and entire repositories. The analysis adapts to security, architecture, and style concerns, aggregating multi-file findings into a unified Hall of Shame to guide refactoring.

How do I generate a prioritized remediation plan for codebase refactoring?

To generate a prioritized remediation plan for codebase refactoring, run a code roast on the target directory. It will return a structured list of detected sins ranked by a severity taxonomy, complete with pragmatic redemption suggestions and owner responsibilities.

Does automated code roasting work for architecture and style concerns or just security?

Automated code roasting works for architecture and style concerns as well as security. The analysis adapts its sin detection to the specific context of the codebase, targeting structural flaws, style inconsistencies, and security risks equally.