What is a Claude Code Skill?

A skill is a specialized reference guide, pattern, or tool definition that enhances Claude's behavior and decision-making for specific domain tasks.

How do subagents help in skill creation?

Subagents are used to simulate pressure scenarios where the skill's instructions are tested, revealing where the AI might rationalize or ignore rules.

What is Claude Search Optimization (CSO)?

CSO is a set of practices including rich descriptions and keyword coverage that help Claude find and load the most relevant skill for a specific task.

Why use TDD for writing documentation?

TDD ensures documentation actually solves a problem by proving an agent fails without it and passes with it, eliminating redundant or ineffective instructions.

Writing Skills (TDD for Documentation)

Name: Writing Skills (TDD for Documentation)
Author: franroa

byfranroa

0•

Learning & Documentation

Applies Test-Driven Development principles to create robust, failure-proof Claude Code skills and process documentation.

This skill formalizes the process of skill creation by treating documentation like software development. It implements a strict Red-Green-Refactor cycle where documentation is pressure-tested against AI subagents to identify loopholes and rationalizations before being finalized. By forcing the author to witness a baseline failure, it ensures every piece of documentation serves a proven purpose, remains token-efficient, and effectively guides AI behavior across diverse scenarios. It includes standardized patterns for SKILL.md structure and Claude Search Optimization (CSO).

Key Features

01Subagent pressure-testing and scenario simulation

02Claude Search Optimization (CSO) for discovery

03Token-efficient documentation and cross-referencing patterns

04Red-Green-Refactor documentation workflow

05Standardized SKILL.md YAML frontmatter and structure

060 GitHub stars

Use Cases

01Refining existing workflows to prevent AI 'loopholes' and rationalizations

02Standardizing team-wide process documentation for high-compliance tasks

03Creating new specialized Claude Code skills from scratch

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add franroa/chezmoi writing-skills

For use in Claude.ai and ChatGPT

Download Skill