writing-skills
Use when creating new skills, editing existing skills, or verifying skills work before deployment
Install
With your agent
Install OMGSkills skill "obra/superpowers:writing-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/superpowers /tmp/superpowers && ln -s /tmp/superpowers/skills/writing-skills ~/.claude/skills/writing-skillsFrom README
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 or 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. 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, see references/anthropic-best-practices.md.
More from this repo
systematic-debugging
Used when encountering any bug, test failure, or unexpected behavior, before proposing fixes
executing-plans
Used when executing an implementation plan in the current session as the implementer yourself — your human partner...
subagent-driven-development
Used when executing implementation plans with independent tasks in the current session