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.

主な機能

01Token-efficient documentation patterns

02Test-Driven Development (TDD) workflow for documentation

03Standardized SKILL.md structural templates

046 GitHub stars

05Claude Search Optimization (CSO) best practices

06Pressure scenario testing to verify agent compliance

ユースケース

01Reducing agent hallucinations through verified instruction sets

02Building a reusable library of team-specific coding standards

03Codifying domain-specific architectural patterns for AI agents

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add ericoo0/stock-trading-platform writing-skills

For use in Claude.ai and ChatGPT

Download Skill