What is the Iron Law of skill creation?

The Iron Law states that no skill should be created or edited without a failing test case first, proving the documentation actually solves a specific failure mode.

How do I keep my Claude skills token-efficient?

Focus on 'Use when...' triggers, move heavy references to separate files, and use explicit cross-references instead of repeating instructions across multiple skills.

What is a Claude Code Skill?

A skill is a specialized reference guide that provides Claude with proven techniques, patterns, or tools to improve its performance and consistency in specific domains.

What is Claude Search Optimization (CSO)?

CSO is the practice of optimizing skill descriptions and keywords so that Claude can accurately find and load the most relevant skills for a given task based on triggering conditions.

Why use TDD for writing documentation?

TDD ensures a skill actually works by requiring you to witness an agent failing a task before the documentation is written and passing it once the skill is applied.

Writing Skills for Claude Code

Name: Writing Skills for Claude Code
Author: yusoofsh

byyusoofsh

0•

学习与文档

Applies Test-Driven Development (TDD) principles to the creation and optimization of Claude Code skills through pressure-testing and subagent verification.

Writing Skills provides a rigorous framework for authoring and optimizing Claude Code skills using a Test-Driven Development (TDD) approach. By requiring developers to witness agent failure before writing documentation, it ensures every skill is bulletproof against AI rationalization and halluncination. The skill covers essential patterns for Claude Search Optimization (CSO), token-efficient documentation, and cross-referencing, helping users create high-impact, discoverable, and reliable process documentation for AI agents.

主要功能

01Subagent pressure-testing and verification techniques

02Standardized SKILL.md structure and YAML frontmatter

03Token-efficient writing patterns for low-context overhead

04TDD-based documentation workflow (Red-Green-Refactor)

05Claude Search Optimization (CSO) best practices

060 GitHub stars

使用场景

01Developing domain-specific AI guidance for complex legacy systems

02Standardizing team-wide coding patterns and project conventions for AI agents

03Optimizing existing Claude skills to reduce token consumption and improve reliability

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add yusoofsh/dotfiles writing-skills

For use in Claude.ai and ChatGPT

Download Skill