How does TDD apply to writing skills?

You write a pressure scenario (test), watch the agent fail to follow the desired logic (red), write the skill documentation (green), and then refine the documentation to close loopholes (refactor).

What is Claude Search Optimization (CSO)?

CSO involves writing specific triggers and descriptions that help Claude's internal retrieval system accurately identify when a skill should be loaded into the context window.

Why shouldn't I summarize the workflow in the description?

Summarizing the workflow in the metadata can cause Claude to take a 'shortcut' and follow the brief summary instead of reading the full, detailed skill instructions.

What is a Claude Code Skill?

A Claude Code Skill is a specialized capability that enhances Claude's behavior by providing domain-specific guidance, best practices, and implementation patterns.

Where do these skills live locally?

Personal skills are typically stored in agent-specific directories like ~/.claude/skills for Claude Code or ~/.codex/skills for Codex.

AI Skill Authoring & Documentation

Name: AI Skill Authoring & Documentation
Author: ZhanlinCui

byZhanlinCui

•

115

•

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

Applies Test-Driven Development principles to create high-quality, discoverable AI agent skills.

AI Skill Authoring provides a rigorous framework for developing and documenting agent capabilities using a Test-Driven Development (TDD) approach. It focuses on creating reliable SKILL.md files by validating agent behavior against 'pressure scenarios' before and after documentation is applied. This skill ensures that every capability is token-efficient, easily discoverable via Claude Search Optimization (CSO), and provides clear guidance for complex technical or enterprise workflows, effectively treating process documentation as production code.

主な機能

01Red-Green-Refactor cycle for AI documentation

02Claude Search Optimization (CSO) for better discovery

03Token-efficient authoring to save context window

04Pressure-test scenarios for agent compliance

05Standardized SKILL.md structure and metadata

06115 GitHub stars

ユースケース

01Developing high-performance technical reference guides

02Standardizing organizational AI agent behaviors

03Debugging and refining inconsistent agent workflows

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add zhanlincui/agent-skills-hunter writing-skills

For use in Claude.ai and ChatGPT

Download Skill