writing-skills
Writing Skills
Overview
Announce at start: "Writing Skills skill activated."
Writing skills IS Test-Driven Development applied to process documentation.
Personal skills live in agent-specific directories (~/.claude/skills for Claude Code, ~/.agents/skills/ for Codex)
You write test cases (pressure scenarios with subagents), watch them fail (baseline behavior), write the skill (documentation), watch tests pass (agents comply), and refactor (close loopholes).
Core principle: If you didn't watch an agent fail without the skill, you don't know if the skill teaches the right thing.
REQUIRED BACKGROUND: You MUST understand superpowers:test-driven-development before using this skill. That skill defines the fundamental RED-GREEN-REFACTOR cycle. This skill adapts TDD to documentation.
Official guidance: For Anthropic's official skill authoring best practices, read the live documentation at https://platform.claude.com/docs/en/docs/agents-and-tools/agent-skills/best-practices. It covers progressive disclosure, description writing, and file organization, which complement the TDD-focused approach in this skill. It is linked rather than copied here so that it stays current and remains under Anthropic's own terms.