Documentation
README
Writing Skills
When to use
- Creating a new skill
- Editing an existing skill
- Skill needs to resist rationalization under pressure
Skip when
- Writing pure reference skill (API docs) → no rules to test
- Skill has no compliance costs → no rationalization risk
Related
Complementary: ring:testing-skills-with-subagents
Writing skills IS TDD applied to process documentation.
Same Iron Law: No skill without failing test first.
Same cycle: RED (baseline) → GREEN (write skill) → REFACTOR (close loopholes).
REQUIRED BACKGROUND: Understand ring:test-driven-development before using this skill.
What is a Skill?
A reusable reference guide for proven techniques, patterns, or tools. Not a narrative about how you solved something once.
This is the opening of the README. Read the full README on GitHub.