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.