testing-skills-with-subagents

Automate RED-GREEN-REFACTOR testing of CLAUDE.md skills using subagents.

Updated Jul 14, 2025
One-click install
npx skills add https://github.com/woodrowpearson/mids-hero-web --skill testing-skills-with-subagents-woodrowpearson
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: testing-skills-with-subagents
Source: https://github.com/woodrowpearson/mids-hero-web/tree/main/.claude/skills/testing-skills-with-subagents
Command: npx skills add https://github.com/woodrowpearson/mids-hero-web --skill testing-skills-with-subagents-woodrowpearson

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams validate CLAUDE.md skills by applying a TDD-style cycle using subagents, enabling rigorous verification of documentation-driven behavior under pressure.

Core Features & Use Cases

  • Automated RED-GREEN-REFACTOR testing of CLAUDE.md skills with subagents.
  • Verbatim rationalization capture and rationalization-table updates to close loopholes.
  • Meta-testing and improvement by challenging skills on edge cases and collecting improvement prompts.

Quick Start

Place your CLAUDE.md skill under .claude/skills/ and run the testing workflow to execute baseline (RED), GREEN skill writing, and REFACTOR cycles against the skill.

Frequently Asked Questions about testing-skills-with-subagents

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

FAQPage Schema
How do I test CLAUDE.md skills using TDD with subagents?▼

You test CLAUDE.md skills with subagents by running an automated RED-GREEN-REFACTOR cycle that validates documentation-driven behavior under pressure. This workflow executes baseline RED tests, GREEN skill writing, and refactoring cycles to rigorously verify skills.

What is rationalization capture in skill testing?▼

Rationalization capture records verbatim rationalizations during skill testing to close loopholes in documentation. Captured rationalizations are compiled into a rationalization table, which is updated continuously to ensure skills comply with their defined behavior.

How do I start testing a CLAUDE.md skill in my project?▼

To start testing a CLAUDE.md skill, place your skill file under the .claude/skills/ directory and run the testing workflow. The workflow executes the baseline RED, GREEN skill writing, and REFACTOR cycles against your skill automatically.

Can I use subagents to validate edge cases in CLAUDE skills?▼

Yes, you can use subagents to validate edge cases through meta-testing. The testing workflow challenges skills on edge cases and collects improvement prompts to ensure robust compliance and close documentation loopholes.

Why does my CLAUDE.md skill fail under pressure testing?▼

CLAUDE.md skills fail under pressure testing when verbatim rationalizations expose loopholes in the documentation. The RED-GREEN-REFACTOR cycle captures these rationalizations and updates the rationalization table to enforce strict compliance.