roast-my-agents-md

Audit AI instruction files for redundancy and ineffectiveness using static analysis and A/B testing.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill provides a brutally honest, evidence-backed review of your AI configuration files (like AGENTS.md or CLAUDE.md), proving which instructions are redundant or ineffective.

Core Features & Use Cases

  • Static Roast: Performs a quick audit for common "sins" like bloat, redundancy, and anti-patterns, with a comedic tone.
  • Evidence Round: Conducts A/B tests to empirically prove which rules the AI already follows without explicit instruction, identifying "dead weight."
  • Verdict & Fixes: Delivers a data-backed score and offers actionable steps for optimization and restructuring.
  • Use Case: You've spent hours crafting a detailed AGENTS.md file. Use this Skill to get objective proof of which parts are actually helping and which are just costing you tokens.

Quick Start

Use the roast-my-agents-md skill to audit my AGENTS.md file.

Frequently Asked Questions about roast-my-agents-md

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

FAQPage Schema
How do I audit AGENTS.md files for redundant or ineffective instructions?

To audit AGENTS.md files for redundant instructions, you can use static analysis and A/B testing to identify dead weight rules, providing evidence-based recommendations for optimization and reducing token costs.

What is A/B testing for AI instruction tuning and how does it work?

A/B testing for AI instruction tuning empirically proves which rules the AI already follows without explicit instruction, identifying dead weight and delivering a data-backed score for configuration optimization.

How do I reduce token costs caused by bloat in CLAUDE.md configuration files?

To reduce token costs caused by bloat in CLAUDE.md files, perform a static audit to detect anti-patterns and redundancy, then apply data-backed restructuring steps to remove ineffective instructions.

What is the best way to optimize AI performance through prompt engineering and instruction tuning?

The best way to optimize AI performance through instruction tuning is to conduct A/B tests that empirically prove rule effectiveness, then apply evidence-based recommendations to restructure your configuration.

Can I use static analysis to find anti-patterns in my AI configuration files?

Yes, you can use static analysis to quickly audit AI configuration files for common anti-patterns, bloat, and redundancy, providing a data-backed score and actionable steps for optimization.

When should I restructure my AI configuration files to improve performance?

You should restructure your AI configuration files when A/B testing identifies dead weight instructions that the AI already follows without explicit rules, proving they are ineffective and increasing token costs.