writing-skills

Community

Installation

Terminal

git clone --depth 1 https://github.com/obra/superpowers.git /tmp/writing-skills-src
cp -r /tmp/writing-skills-src/skills/writing-skills ~/.claude/skills/writing-skills

Or .claude/skills/writing-skills to scope it to one repo.

Summary

Use when creating new skills, editing existing skills, or verifying skills work before deployment

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: F…

Questions

Use when creating new skills, editing existing skills, or verifying skills work before deployment

Claude Code: ~/.claude/skills/writing-skills. Codex: ~/.agents/skills/writing-skills. Antigravity: ~/.gemini/config/skills/writing-skills. Use .claude/skills or .agents/skills inside a repo to scope it to one project.

More from obra/superpowers

Name