$ skilldirectory
— zsh — registry.skilldirectory.dev
skill library blog

home / Writing / Writing Skills Skill by @obra

Writing Skills Skill by @obra

FREE
github stars★ 2,90,001updatedSep 2026repo@obra
$git clone https://github.com/obra/superpowers

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.

Read the opening of the original SKILL.md
# 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.