What is the difference between a skill and a project convention?

Skills are reusable, broad patterns applicable across projects, whereas project-specific conventions belong in a CLAUDE.md file.

How do I optimize a skill for Claude to find it?

Use Claude Search Optimization (CSO) by focusing the description on 'when to use' rather than 'what it does' and including specific error symptoms or keywords.

What is the Iron Law of skill creation?

The Iron Law states there is no skill without a failing test first. You must observe the agent failing a task before writing the documentation to fix it.

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

Summarizing the workflow in the description can cause Claude to follow the summary instead of reading the full skill body, leading to lower compliance.

Claude Skill Authoring & Documentation

Name: Claude Skill Authoring & Documentation
Author: newkayak12

bynewkayak12

0•

Learning & Documentation

Standardizes the creation and maintenance of Claude Code skills using a rigorous Test-Driven Development (TDD) approach for process documentation.

This skill applies the principles of Test-Driven Development to the creation of Claude Code skills, ensuring that every documentation piece is verified against actual agent behavior. By following a Red-Green-Refactor cycle—writing failing pressure scenarios before drafting documentation—users can build reliable, high-performance skills that Claude can discover and execute effectively. It focuses on Claude Search Optimization (CSO) to ensure skills are triggered only when needed, preventing context bloat while maintaining strict compliance with established implementation patterns.

Key Features

01Keyword and trigger condition optimization

02TDD-based documentation workflow (Red-Green-Refactor)

03Claude Search Optimization (CSO) for discovery

04Standardized SKILL.md structure and YAML frontmatter

050 GitHub stars

06Pressure scenario testing with subagents

Use Cases

01Standardizing team-wide process documentation for agentic workflows

02Capturing complex coding patterns into reusable AI skills

03Improving existing skill descriptions for better discovery

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add newkayak12/claude-skills writing-skills

For use in Claude.ai and ChatGPT

Key Features

01Keyword and trigger condition optimization

02TDD-based documentation workflow (Red-Green-Refactor)

03Claude Search Optimization (CSO) for discovery

04Standardized SKILL.md structure and YAML frontmatter

050 GitHub stars

06Pressure scenario testing with subagents

Use Cases

01Standardizing team-wide process documentation for agentic workflows

02Capturing complex coding patterns into reusable AI skills

03Improving existing skill descriptions for better discovery

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add newkayak12/claude-skills writing-skills

For use in Claude.ai and ChatGPT