writing-skillslisted

# Writing Skills ## Contents - [Overview](#overview) - [What Is a Skill?](#what-is-a-skill) - [Applying TDD to Writing Skills](#applying-tdd-to-writing-skills) - [Closed-Loop Checkpoints](#closed-loop-checkpoints) - [When to Write a Skill](#when-to-write-a-skill) - [Skill Types](#skill-types) - [Directory Structure](#directory-structure) - [SKILL.md Structure](#skillmd-structure) - [Claude Search Optimization](#claude-search-optimization) - [The Role of the Description Field](#the-role-of-the-description-field) - [Keyword Coverage](#keyword-coverage) - [Token Efficiency](#token-efficiency) - [Referencing Other Skills](#referencing-other-skills) - [The Iron Law (Same as TDD)](#the-iron-law-same-as-tdd) - [Test Strategy](#test-strategy) - [Red Flags. Signs to Stop and Start Over.](#red-flags-signs-to-stop-and-start-over) - [The RED-GREEN-REFACTOR Cycle](#the-red-green-refactor-cycle) - [Skill-Writing Checklist (TDD Adapted)](#skill-writing-checklist-tdd-adapted) - [Using Flowcharts](#using-flowcharts) - [Code Examples](#code-examples) - [STOP: Before Moving to the Next Skill](#stop-before-moving-to-the-next-skill) - [Discovery Workflow](#discovery-workflow) - [Summary](#summary) - [Reference Documents](#reference-documents) ## Overview Writing a skill applies TDD (test-driven development) to process documentation. Write the test cases first (pressure scenarios), observe the failure (the baseline), write the skill document (the implementation), and confirm success ag