What is Claude Search Optimization (CSO)?

CSO is a set of techniques, such as specific description formatting and keyword coverage, that ensures Claude can accurately find and trigger the correct skill for a user's request.

When should I create a skill versus updating CLAUDE.md?

Create a skill for reusable techniques or patterns that apply across multiple projects. Use CLAUDE.md for project-specific conventions and mechanical constraints.

Why use TDD for documentation and skills?

Applying TDD to documentation ensures the instructions actually solve a problem. By watching an agent fail without the skill (Red) and pass with it (Green), you verify the skill teaches the right behavior.

What is a Claude Code Skill?

A Claude Code Skill is a specialized capability that provides domain-specific guidance, best practices, and implementation patterns to improve Claude's behavior during specific tasks.

How does this skill help with token efficiency?

It provides guidelines for progressive disclosure, target word counts, and cross-referencing to ensure skills remain concise and don't consume excessive context.

Skill Authoring & TDD Documentation

Name: Skill Authoring & TDD Documentation
Author: claudiodearaujo

byclaudiodearaujo

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

Implements Test-Driven Development patterns to create, verify, and optimize reusable Claude Code skills and documentation.

概要

This skill applies the rigorous Red-Green-Refactor cycle of Test-Driven Development to the process of authoring AI instructions and documentation. By establishing baseline failures through pressure scenarios and iteratively refining skill definitions, it ensures that new capabilities are both effective and token-efficient. It serves as a comprehensive framework for developers looking to build robust, discoverable, and high-performance skills for Claude Code and Codex environments, focusing on the principle that if you haven't seen an agent fail without a skill, you cannot verify the skill's effectiveness.

主な機能

TDD-based skill validation workflow (Red-Green-Refactor)
Pressure scenario testing for agent compliance
Standardized SKILL.md structure templates
0 GitHub stars
Token efficiency and progressive disclosure guidelines
Claude Search Optimization (CSO) best practices

ユースケース

Verifying that new system instructions actually solve specific agent failures
Developing new domain-specific capabilities for Claude Code
Refactoring existing documentation for better AI discovery and adherence

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add claudiodearaujo/sistema-de-narra-o-de-livro-front writing-skills

For use in Claude.ai and ChatGPT

Download Skill

GitHub

概要