What is a Claude Code Skill?

A skill is a specialized, reusable reference guide containing techniques, patterns, or tools that enhance Claude's behavior and decision-making across different projects.

When should I create a new skill vs. project documentation?

Create a skill when a technique applies broadly across multiple projects; use project documentation (like CLAUDE.md) for conventions specific to a single codebase.

How does this help with context limits?

The framework provides specific guidelines for token efficiency, such as keeping core SKILL.md files under 500 words and using progressive disclosure for heavy references.

What is Claude Search Optimization (CSO)?

CSO is the practice of writing metadata and descriptions in a way that allows Claude to accurately identify, search for, and load the most relevant skill for any given task.

Why use TDD for writing skills?

Test-Driven Development ensures a skill is actually effective by forcing you to watch an agent fail a task (the Red phase) without the skill before documenting the solution.

Claude Skill Writing & TDD Framework

Name: Claude Skill Writing & TDD Framework
Author: claudiodearaujo

byclaudiodearaujo

0•

開発者ツール

Implements Test-Driven Development principles for creating, testing, and refining Claude Code skills to ensure reliable AI behavior.

This skill provides a rigorous, TDD-inspired framework for developing Claude Code skills, moving beyond simple documentation to a Red-Green-Refactor cycle for process improvement. By requiring developers to first observe an agent failing a task without the skill, it ensures that every instruction added is necessary and effective. It establishes standards for directory structures, Claude Search Optimization (CSO), token efficiency, and best practices for naming and cross-referencing to build a high-performance library of reusable AI capabilities.

主な機能

01Standardized SKILL.md templates and metadata formatting

02Verification methods using pressure scenarios and subagents

030 GitHub stars

04TDD-based skill creation workflow (Red-Green-Refactor)

05Claude Search Optimization (CSO) guidelines for better discovery

06Token-efficient documentation patterns and directory structures

ユースケース

01Developing custom reusable behaviors for Claude Code agents

02Optimizing existing skill libraries for searchability and context efficiency

03Testing and validating that documentation actually influences agent logic

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