How do I make my skills easier for Claude to find?

Use 'Use when...' in descriptions to focus on triggering conditions and include specific keywords like error messages or symptoms Claude might encounter.

Why shouldn't I summarize the workflow in the skill description?

Summarizing the workflow in the description creates a 'shortcut' where Claude may follow the brief summary instead of reading the full, detailed skill content.

How does TDD apply to documentation?

You write a test case (a pressure scenario), watch the agent fail without the skill (Red), write the skill (Green), and then refine the documentation (Refactor) to ensure compliance.

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.

What is the recommended file structure for a skill?

Skills should live in a dedicated directory with a mandatory SKILL.md file containing YAML frontmatter with 'name' and 'description' fields.

Process Documentation & Skill Writing

Name: Process Documentation & Skill Writing
Author: SwervoJake

bySwervoJake

0•

Learning & Documentation

Applies Test-Driven Development principles to creating, testing, and optimizing Claude Code skills and process documentation.

This skill transforms how instructions and skills are authored by applying a rigorous Red-Green-Refactor cycle to documentation. Instead of writing passive narratives, it guides users to create pressure scenarios that test agent compliance, ensuring that every skill effectively influences AI behavior. It includes specific optimizations for Claude's search discovery, token efficiency guidelines, and standardized structures for maintaining high-quality specialized capabilities within an AI-driven development environment.

Key Features

010 GitHub stars

02Pressure testing protocols using subagent scenarios

03TDD-based documentation workflow for verified agent compliance

04Standardized SKILL.md structure with YAML frontmatter guidelines

05Claude Search Optimization (CSO) patterns for better skill discovery

06Token efficiency techniques to minimize context window consumption

Use Cases

01Refining ambiguous internal documentation that agents fail to follow

02Developing new domain-specific capabilities for Claude Code

03Standardizing processes for AI-run studios and automated workflows

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

010 GitHub stars

02Pressure testing protocols using subagent scenarios

03TDD-based documentation workflow for verified agent compliance

04Standardized SKILL.md structure with YAML frontmatter guidelines

05Claude Search Optimization (CSO) patterns for better skill discovery

06Token efficiency techniques to minimize context window consumption

Use Cases

01Refining ambiguous internal documentation that agents fail to follow

02Developing new domain-specific capabilities for Claude Code

03Standardizing processes for AI-run studios and automated workflows

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