skills sourced live from GitHub · all skills listed are free · each skill is provided under its author's license.
home / Writing / Writing Skills Skill by @obra
The skill is the skills/writing-skills folder inside that repository. Copy it into the folder your agent loads skills from; check your agent's documentation for where that is.
Use when creating new skills, editing existing skills, or verifying skills work before deployment.
Explains how to write, edit and verify skills themselves, mapping test-driven development onto skill creation, with guidance on when a skill is worth creating and what types exist.
The original SKILL.md is organised into these sections:
Written and maintained by @obra. It is published under the MIT license, which allows reuse with attribution. See the author profile. SkillDirectory does not claim authorship: this page adds our own review and links back to the original, and the skill's text belongs to its author.
# Writing Skills ## Overview **Writing skills IS Test-Driven Development applied to process documentation.** **Personal skills live in your runtime's skills directory** (`~/.claude/skills/` on Claude Code) — see [codex-tools.md](../using-superpowers/references/codex-tools.md) or [gemini-tools.md](../using-superpowers/references/gemini-tools.md) for the path on those runtimes. Codex, Copilot CLI, and Gemini CLI all also recognize `~/.agents/skills/` as a cross-runtime alias. 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. …
Excerpt only, quoted from the author's repository. Open the repository for the complete file.