How does TDD apply to writing skills?

You first create a pressure scenario where the agent fails (Red), write the skill documentation (Green), and then refine the skill to close behavioral loopholes (Refactor).

Why shouldn't skill descriptions summarize the workflow?

If a description summarizes the workflow, Claude may follow the summary as a shortcut and ignore the more detailed instructions contained within the full skill body.

Where should I store my Claude Code skills?

Personal skills for Claude Code typically live in the ~/.claude/skills directory, while Codex agents use the ~/.agents/skills/ directory.

What is a Claude Code Skill?

A Claude Code Skill is a specialized capability or reference guide that enhances Claude's behavior by providing domain-specific guidance, patterns, and best practices.

What makes a skill search-optimized for Claude?

Effective skills use 'Use when' triggers in descriptions, include specific error messages as keywords, and avoid verbose workflows to save on context window tokens.

Agent Skill Authoring & Documentation

Name: Agent Skill Authoring & Documentation
Author: SwervoJake

bySwervoJake

0•

Learning & Documentation

Applies test-driven development principles to the creation and optimization of specialized Claude Code skills and process documentation.

This skill provides a rigorous framework for developing high-quality Claude Code capabilities by treating process documentation like production code. By utilizing a Red-Green-Refactor cycle—where users first verify an agent fails without guidance before drafting instructions—it ensures every skill addresses real behavioral gaps. The skill includes standardized templates, Claude Search Optimization (CSO) techniques, and best practices for token efficiency, enabling the creation of a robust library of reusable agent behaviors.

Key Features

01Test-Driven Development (TDD) workflow for documentation

020 GitHub stars

03Claude Search Optimization (CSO) for improved discovery

04Pressure-scenario testing for agent compliance verification

05Token-efficient patterns and cross-referencing guidelines

06Standardized SKILL.md templates and frontmatter structure

Use Cases

01Closing behavioral loopholes in agent execution through systematic refactoring

02Standardizing complex team-wide coding patterns and best practices

03Creating reusable domain-specific reference guides for AI agents

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add swervojake/claaaude-studio writing-skills

For use in Claude.ai and ChatGPT

Key Features

01Test-Driven Development (TDD) workflow for documentation

020 GitHub stars

03Claude Search Optimization (CSO) for improved discovery

04Pressure-scenario testing for agent compliance verification

05Token-efficient patterns and cross-referencing guidelines

06Standardized SKILL.md templates and frontmatter structure

Use Cases

01Closing behavioral loopholes in agent execution through systematic refactoring

02Standardizing complex team-wide coding patterns and best practices

03Creating reusable domain-specific reference guides for AI agents

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add swervojake/claaaude-studio writing-skills

For use in Claude.ai and ChatGPT