What is Claude Search Optimization (CSO)?

CSO is a set of practices including rich keyword coverage and specific 'Use when' triggers that help Claude's retrieval system find and load the correct skill for a specific task.

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

If the description summarizes the process, Claude may follow the summary instead of reading the full skill content, leading to skipped steps and lower quality output.

How do I keep my skills token-efficient?

By moving heavy details to tool help files, using cross-references instead of repeating instructions, and aiming for word counts under 200 words for frequently loaded skills.

What is Test-Driven Development for skills?

It is the process of creating a pressure scenario to watch an agent fail a task, writing a skill to address that failure, and then verifying the agent now complies with the new instructions.

Claude Code Skill Authoring

Name: Claude Code Skill Authoring
Author: pedropaulovc

bypedropaulovc

0•

Learning & Documentation

Applies Test-Driven Development principles to creating, verifying, and optimizing specialized Claude Code skills.

This skill provides a rigorous framework for developing Claude Code skills by treating documentation as production code. By following a Red-Green-Refactor cycle—where you verify an agent fails a task before the skill exists and succeeds once it is applied—you ensure every piece of documentation serves a functional purpose. It includes advanced strategies for Claude Search Optimization (CSO) and token efficiency, helping users build a high-performance personal marketplace of agent capabilities that are easily discoverable and consistently followed.

Key Features

010 GitHub stars

02Claude Search Optimization (CSO) for better skill discovery

03Red-Green-Refactor workflow for process documentation

04Standardized SKILL.md structure with YAML frontmatter

05Token-efficient documentation patterns and cross-referencing

06Pressure-test scenarios for verifying agent compliance

Use Cases

01Scaling agent capabilities without bloating the global system prompt

02Refactoring existing agent instructions for better discovery and compliance

03Codifying reusable engineering patterns and team-specific workflows

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add pedropaulovc/personal-marketplace writing-skills

For use in Claude.ai and ChatGPT

Download Skill