What is Claude Search Optimization (CSO)?

CSO is the practice of writing skill descriptions focused on 'triggering conditions' so Claude can accurately identify when a skill should be loaded.

What is a Claude Code Skill?

A skill is a specialized reference guide containing proven techniques, patterns, or tools that help Claude apply effective approaches to specific tasks.

Why is token efficiency important for skills?

Skills are loaded into the AI's context window. Keeping them concise ensures you don't waste tokens on documentation, leaving more room for your code and logic.

How does TDD apply to writing documentation?

You write a test case (scenario), watch the agent fail without the skill (Red), write the skill (Green), and then refactor to close loopholes and optimize tokens.

Skill Authoring & Documentation TDD

Name: Skill Authoring & Documentation TDD
Author: LyQing63

byLyQing63

0•

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

Standardizes the creation of Claude Code skills using Test-Driven Development principles for documentation.

This skill applies the Red-Green-Refactor cycle to the creation of Claude Code skills, treating process documentation like production code. It ensures that every skill is validated against actual agent behavior by testing baseline failures before documenting solutions. By prioritizing Claude Search Optimization (CSO) and token efficiency, it helps developers build a library of highly discoverable, concise, and functional reference guides that improve AI performance across diverse technical domains.

主な機能

01TDD workflow for documentation (Red-Green-Refactor)

02Graphviz flowchart integration for complex logic

03Claude Search Optimization (CSO) for better skill discovery

040 GitHub stars

05Standardized SKILL.md structure and YAML frontmatter

06Token efficiency guidelines to preserve context window

ユースケース

01Creating reusable domain-specific guidance for AI agents

02Refactoring existing documentation to improve discovery

03Validating that a custom skill effectively changes agent behavior

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add lyqing63/lyqing.opencode writing-skills

For use in Claude.ai and ChatGPT

Download Skill