Download for MacApple silicon, macOS 14+
Skill

Creating Skills

@obra Updated 2025-10-09

TDD for process documentation - test with subagents before writing, iterate until bulletproof

Install

With your agent

Install OMGSkills skill "obra/clank:creating-skills" into this agent's normal skills directory: call the OMGSkills MCP get_install_plan tool for your agent and run the script it returns (it installs only the pinned commit and verifies SKILL.md), and stop if MCP or the pin is unavailable. Do not overwrite or change existing skills without asking me.

Manual command

git clone https://github.com/obra/clank /tmp/clank && ln -s /tmp/clank/skills/meta/creating-skills ~/.claude/skills/Creating Skills

From README

Creating Skills Overview Creating skills IS Test-Driven Development applied to process documentation. 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. See skills/testing/test-driven-development for the fundamental RED-GREEN-REFACTOR cycle. This skill adapts TDD to documentation. 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.