What is an AI rationalization?

An AI rationalization is an excuse the agent gives (e.g., 'this is too simple to test' or 'the context is clear') to skip a step. This skill provides explicit counters to block these behaviors.

When should I create a new Claude Skill versus a simple prompt?

Create a skill when a technique isn't intuitively obvious, when you need to reference it across multiple projects, or when the pattern applies broadly to your workflow rather than a one-off task.

What does it mean to apply TDD to a Claude Skill?

Just like Test-Driven Development in coding, it means creating a 'failing' scenario where Claude fails to follow a specific instruction or pattern, then writing the skill documentation to fix that failure, and finally refactoring for efficiency.

How do you test if a skill actually works?

The framework uses 'pressure scenarios'—simulated environments involving time constraints or sunk-cost fallacies—conducted by subagents to see if the main agent violates the proposed skill rules.

Skill Writing & TDD Framework

Name: Skill Writing & TDD Framework
Author: ed3dai

byed3dai

•

Learning & Documentation

Applies Test-Driven Development principles to the creation of Claude Code skills to ensure robust, loophole-free AI directives.

This skill provides a rigorous methodology for developing and validating custom Claude Code skills by treating process documentation like production code. By implementing a Red-Green-Refactor cycle—where developers first identify baseline failures through pressure scenarios using subagents—the framework ensures that new skills are bulletproofed against AI rationalizations and inconsistencies. It includes standardized templates, directory structures, and a checklist to ensure every instruction is tested for compliance under stress before deployment.

Key Features

01Pressure scenario testing using subagents to find loopholes

02Validation techniques for discipline, technique, and pattern skills

0345 GitHub stars

04Red-Green-Refactor cycle for documentation and skills

05Standardized SKILL.md template for consistent documentation

06Rationalization blocking to prevent AI from bypassing rules

Use Cases

01Verifying that complex instructions are followed during high-pressure tasks

02Creating high-reliability coding standards for team repositories

03Building a library of reusable AI patterns that won't degrade over time

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add ed3dai/ed3d-plugins writing-skills

For use in Claude.ai and ChatGPT

Download Skill