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.