writing-skills

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

Content Preview
---
name: writing-skills
description: 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 agent-specific directories (`~/.claude/skills` for Claude Code, `~/.agents/skills/` for Codex)** 

You write test cases (pressure scenarios with subagents), watch them fail (baseline behavior), write the skill (documentat
How to Use

Recommended: Install to project (local)

mkdir -p .claude/skills
curl -o .claude/skills/writing-skills.md \
  https://raw.githubusercontent.com/obra/superpowers/main/skills/writing-skills/SKILL.md

Skill is scoped to this project only. Add .claude/skills/ to your .gitignoreif you don't want to commit it.

Alternative: Clone full repo

git clone https://github.com/obra/superpowers

Then reference at skills/writing-skills/SKILL.md

Related Skills