How does this skill help with token management?

It provides strategies for token efficiency, such as moving details to tool help, using cross-references, and compressing examples to keep frequently-loaded skills under 200 words.

What is the most important part of a skill's description?

The description must focus solely on triggering conditions (starting with 'Use when...') and avoid summarizing the workflow to ensure Claude reads the full skill content instead of taking shortcuts.

How do you apply TDD to writing skills?

You create a pressure scenario where an agent fails to follow a process (Red), write the skill documentation (Green), and then refactor the skill to close any loopholes or improve token efficiency.

What is a Claude Code Skill?

A Claude Code Skill is a specialized reference guide that provides domain-specific guidance, patterns, and tools to enhance an agent's behavior during specific tasks.

Claude Skill Authoring & TDD Documentation

Name: Claude Skill Authoring & TDD Documentation
Author: clsandoval

byclsandoval

0•

学習とドキュメンテーション

Standardizes the creation and verification of Claude Code skills using a Test-Driven Development (TDD) approach to process documentation.

This skill provides a rigorous framework for developing Claude Code skills by applying Test-Driven Development (TDD) principles to documentation. It guides users through the Red-Green-Refactor cycle: creating pressure scenarios where agents fail, writing documentation to address those specific failures, and verifying compliance. By focusing on Claude Search Optimization (CSO) and token efficiency, it ensures that new capabilities are easily discoverable by AI agents without prematurely exhausting context windows.

主な機能

01Claude Search Optimization (CSO) for better skill discovery

02Pressure scenario testing using subagents to verify skill efficacy

03Red-Green-Refactor workflow for documentation and process guides

040 GitHub stars

05Token-efficient documentation patterns for context management

06Standardized SKILL.md templates and YAML frontmatter configuration

ユースケース

01Developing new domain-specific capabilities for Claude Code or Codex

02Optimizing agent behavior by closing instruction loopholes through iterative testing

03Refactoring existing prompts into reusable, testable skill modules

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add clsandoval/monorepo writing-skills

For use in Claude.ai and ChatGPT