What is Claude Search Optimization (CSO)?

CSO is a set of practices designed to help Claude find and load the correct skill for a task, involving rich descriptions, specific keywords, and active-voice naming conventions.

How do I ensure my skills are token-efficient?

Keep frequently-loaded skills under 200 words, move command details to tool help flags, and use cross-references instead of repeating instructions from other skills.

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

Summarizing the workflow in the YAML description can cause Claude to take a shortcut, following the brief summary instead of reading the full, detailed instructions in the skill body.

What is the core principle of this skill?

The core principle is that writing skills is Test-Driven Development (TDD) applied to process documentation. You must watch an agent fail without the skill to ensure the documentation teaches the correct behavior.

Skill Authoring & TDD Documentation

Name: Skill Authoring & TDD Documentation
Author: tajohnson

bytajohnson

0•

Learning & Documentation

Applies Test-Driven Development principles to the creation, verification, and optimization of AI process documentation.

The writing-skills plugin provides a rigorous framework for developing Claude Code skills by treating process documentation as production code. It utilizes a specialized Red-Green-Refactor cycle where documentation is validated through agent-driven pressure scenarios, ensuring that every skill effectively influences AI behavior. By following these patterns, developers can create highly discoverable, token-efficient, and instructionally sound capabilities that improve the reliability of Claude across diverse technical tasks.

Key Features

010 GitHub stars

02Token-efficient documentation patterns

03Claude Search Optimization (CSO) techniques

04Graphviz flowchart integration standards

05Pressure scenario validation workflows

06Test-Driven Development (TDD) for documentation

Use Cases

01Developing new reusable capabilities for AI agents

02Refactoring existing skills to reduce context window usage

03Verifying agent compliance with process documentation before deployment

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add tajohnson/superpowers writing-skills

For use in Claude.ai and ChatGPT

Key Features

010 GitHub stars

02Token-efficient documentation patterns

03Claude Search Optimization (CSO) techniques

04Graphviz flowchart integration standards

05Pressure scenario validation workflows

06Test-Driven Development (TDD) for documentation

Use Cases

01Developing new reusable capabilities for AI agents

02Refactoring existing skills to reduce context window usage

03Verifying agent compliance with process documentation before deployment

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add tajohnson/superpowers writing-skills

For use in Claude.ai and ChatGPT