What is a Claude Code Skill?

A skill is a specialized capability or reference guide that provides domain-specific guidance, patterns, and tools to enhance Claude's behavior during tasks.

How should I describe a skill for optimal discovery?

Focus the description on 'When to use' the skill, including specific symptoms and triggers, rather than summarizing the internal workflow.

Where are personal Claude Code skills stored?

Personal skills are typically stored in the ~/.claude/skills directory for Claude Code or ~/.codex/skills for Codex.

What is the 'Red-Green-Refactor' cycle in skill writing?

It involves creating a scenario where the agent fails (Red), writing the skill until the agent complies (Green), and then cleaning up the documentation (Refactor).

Why use TDD for writing documentation?

Using TDD for skills ensures the documentation actually works; by watching an agent fail without the skill, you prove the skill teaches the necessary behavior.

Skill Writing Framework

Name: Skill Writing Framework
Author: EricOo0

byEricOo0

•

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

Standardizes the creation of Claude Code skills using a Test-Driven Development (TDD) approach to ensure agent compliance and reliability.

概要

The Skill Writing Framework applies the Red-Green-Refactor cycle to process documentation and agent instructions. It guides developers through creating 'superpowers' for Claude by establishing baseline failures via pressure scenarios, writing minimal documentation to address those failures, and iteratively refactoring to close loopholes. This methodology ensures that every skill added to a repository is verified, token-efficient, and optimized for discovery by AI agents during complex coding tasks.

主な機能

Token-efficient documentation patterns
Test-Driven Development (TDD) workflow for documentation
Standardized SKILL.md structural templates
6 GitHub stars
Claude Search Optimization (CSO) best practices
Pressure scenario testing to verify agent compliance

ユースケース

Reducing agent hallucinations through verified instruction sets
Building a reusable library of team-specific coding standards
Codifying domain-specific architectural patterns for AI agents

概要

主な機能

Token-efficient documentation patterns
Test-Driven Development (TDD) workflow for documentation
Standardized SKILL.md structural templates
6 GitHub stars
Claude Search Optimization (CSO) best practices
Pressure scenario testing to verify agent compliance

ユースケース

Reducing agent hallucinations through verified instruction sets
Building a reusable library of team-specific coding standards
Codifying domain-specific architectural patterns for AI agents