How do I optimize skills for Claude's search?

Use 'Use when' descriptions that focus on triggering conditions and symptoms rather than summarizing the workflow, ensuring Claude reads the full skill content before executing.

Where are personal Claude skills stored?

Personal skills are typically located in ~/.claude/skills for Claude Code or ~/.agents/skills/ for Codex environments.

What is the 'Red-Green-Refactor' cycle for skills?

It involves creating a pressure scenario (Red), implementing the SKILL.md content until the agent complies (Green), and then refining the documentation to close logic gaps (Refactor).

Why use TDD for writing AI skills?

Applying TDD ensures the skill is actually necessary; by watching an agent fail a baseline test, you confirm the skill teaches the right thing and effectively closes behavioral loopholes.

What is a Claude Code Skill?

A skill is a specialized reference guide for proven techniques, patterns, or tools that enhances Claude's behavior when performing specific tasks.

Claude Skill Authoring

Name: Claude Skill Authoring
Author: zerdos

byzerdos

0•

Learning & Documentation

Standardizes the creation and verification of AI-driven skills using a Test-Driven Development approach for documentation.

The Writing Skills plugin provides a rigorous framework for developing high-quality Claude Code skills by applying Test-Driven Development (TDD) principles to process documentation. It guides users through the Red-Green-Refactor cycle—writing pressure scenarios, observing agent failure, implementing documentation, and verifying compliance—to ensure every skill addresses real behavioral gaps. This methodology prevents common pitfalls like workflow shortcuts and token bloat while maximizing discoverability through Claude Search Optimization (CSO) best practices.

Key Features

01Token-efficient documentation and cross-referencing patterns

02Claude Search Optimization (CSO) formatting standards

03TDD-based skill verification workflow (Red-Green-Refactor)

04Standardized SKILL.md directory and YAML structure

05Pressure testing guidelines using subagent scenarios

060 GitHub stars

Use Cases

01Validating agent compliance for mission-critical documentation

02Creating reusable technical reference guides for domain-specific tools

03Encoding complex team-specific engineering standards into AI skills

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add zerdos/superpowers writing-skills

For use in Claude.ai and ChatGPT

Download Skill