writing-skills

# Writing Skills ## Overview **Writing skills uses pressure-scenario validation, not a code TDD route.** **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. **Validation requirement:** Skill changes need a baseline pressure scenario and post-change validation even when TDD mode is `off`; this does not require loading `aegis:test-driven-development`. **Official guidance:** For Anthropic's official skill authoring best practices, see anthropic-best-practices.md. This document provides additional patterns and guidelines that complement the TDD-focused approach in this skill. Bare filenames in this skill refer to files relative to this skill directory unless stated otherwise. ## What is a Skill? A **skill** is a reference guide for proven techniques, patterns, or tools. Skills help future Claude instances find and apply effective approaches. **Skills are:** Reusable techniques, patterns, tools, reference guides **Skills are NOT:** Narratives about how you solved a problem once ## Validation Mapping for Skills | Validation step | Skill Creation | |-------------|----------------| | **...