What is a Claude Code Skill?

A skill is a specialized reference guide or capability that provides domain-specific guidance, patterns, and best practices to enhance AI agent behavior.

What is Agent Search Optimization (ASO)?

ASO involves structuring skill descriptions and keywords so that future agent instances can accurately find and load the most relevant skills for a specific task.

What is the Red-Green-Refactor cycle for skills?

Red: Watch the agent fail a scenario without the skill. Green: Write the skill and watch the agent comply. Refactor: Refine the documentation for clarity and token efficiency.

Why use TDD for writing documentation?

TDD ensures documentation is effective by proving the agent fails without the instruction and succeeds with it, closing loopholes before the skill is deployed.

How do you prevent AI agent rationalization?

This skill teaches you to identify common excuses agents use to skip rules and build explicit 'rationalization tables' that forbid specific workarounds.

TDD for Process Documentation

Name: TDD for Process Documentation
Author: LerianStudio

byLerianStudio

•

学习与文档

Applies Test-Driven Development principles to create resilient, rationalization-proof process documentation for AI agents.

This skill implements a mandatory workflow for authoring Claude Code skills using a rigorous Test-Driven Development (TDD) methodology. By requiring creators to develop 'pressure scenarios' and observe baseline failures before writing documentation, it ensures that every skill is effective, discovery-optimized, and resistant to agent rationalization. It provides a structured Red-Green-Refactor cycle for documentation, resulting in high-quality engineering gates that maintain compliance even when agents are under operational stress.

主要功能

01Pressure scenario testing using subagents

02Agent Search Optimization (ASO) for improved skill discovery

0317 GitHub stars

04Rationalization-prevention tables to close loopholes

05Standardized SKILL.md templates and token efficiency guidelines

06Red-Green-Refactor workflow for documentation authoring

使用场景

01Developing new domain-specific skills that agents must follow strictly

02Hardening existing documentation against AI 'laziness' or shortcuts

03Standardizing software engineering best practices across automated agent workflows

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add lerianstudio/ring writing-skills

For use in Claude.ai and ChatGPT

Download Skill