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

home / Writing / Writing Plans Skill by @obra

Writing Plans Skill by @obra

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

The skill is the skills/writing-plans 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
---
name: writing-plans
description: Use when you have a spec or requirements for a multi-step task, before touching code

# Writing Plans

## Overview

Write comprehensive implementation plans assuming the engineer has zero context for our codebase and questionable taste. Document everything they need to know: which files to touch for each task, code, testing, docs they might need to check, how to test it. Give them the whole plan as bite-sized tasks. DRY. YAGNI. TDD. Frequent commits.

Assume they are a skilled developer, but know almost nothing about our toolset or problem domain. Assume they don't know good test design very well.

**Announce at start:** "I'm using the writing-plans skill to create the implementation plan."

**Context:** If working in an isolated worktree, it should have been created via the `superpowers:using-git-worktrees` skill at execution time.

**Save plans to:** `docs/superpowers/plans/YYYY-MM-DD-<feature-name>.md`
…

Excerpt only, quoted from the author's repository. Open the repository for the complete file.