Skills Directory

obra/superpowers

writing-skills

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

181K installs 281K starsUpdated Sep 1, 2026License: MIT

Install

npx skills add obra/superpowers@writing-skills

Runs in your terminal. Adds the skill globally for Claude Code, Cursor, Codex and others; add -g -y to skip prompts.

What it does

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…

Excerpt from the skill's own SKILL.md. Read the full file on GitHub before installing: skills run with your agent's permissions.

View source on GitHub

Before you install

Skills are plain text instructions the agent follows, sometimes with scripts. Check the source, prefer repositories with many installs and stars, and read any script it ships.

Categories

Related skills

  • brainstorming

    obra/superpowers

    You MUST use this before any creative work - creating features, building components, adding functionality, or modifying behavior. Explores user intent, requirements and design before implementation.

    349K installs 281KDesign & UI
  • systematic-debugging

    obra/superpowers

    Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes

    246K installs 281KTesting
  • writing-plans

    obra/superpowers

    Use when you have a spec or requirements for a multi-step task, before touching code

    238K installs 281KDesign & UITestingDocumentation
  • using-superpowers

    obra/superpowers

    Use when starting any conversation - establishes how to find and use skills, requiring skill invocation before ANY response including clarifying questions

    234K installs 281K
  • requesting-code-review

    obra/superpowers

    Use when completing tasks, implementing major features, or before merging to verify work meets requirements

    218K installs 281KCode reviewGit & GitHub
  • executing-plans

    obra/superpowers

    Use when you have a written implementation plan to execute in a separate session with review checkpoints

    201K installs 281KAI & agentsCode review

← Search skills

/skills/obra/superpowers/writing-skills/