Skip to content
Codex DesignBETA

Superpowers writing plans skill for Codex.

The writing-plans skill from Superpowers turns a spec into an implementation plan detailed enough for an engineer with no context to follow. Every step is small, tested and committed. It ships in the Superpowers plugin by Jesse Vincent.

Updated November 12, 2026 · 3 min read

At a glance

Skill namewriting-plans
Comes withThe Superpowers plugin, by Jesse Vincent
Installcodex plugin add superpowers@openai-curated, or /plugins in Codex
Codex uses itWhen you have a spec or requirements for a multi-step task, before any code is touched
Sourceopenai/plugins on GitHub

What it does

Codex saves the plan to docs/superpowers/plans/ with a fixed header: goal, architecture, tech stack, a link to the spec, and the spec’s global constraints copied word for word. Before writing tasks it maps which files will be created or changed and what each one is for.

Each task then lists:

  • Files: exact paths to create, modify and test, with line ranges for changes.
  • Interfaces: the exact names and types it uses from earlier tasks and provides to later ones.
  • Steps: two-to-five-minute actions in test-driven order: write the failing test, run it, write the minimal code, run it again, commit. Each code step includes the actual code and command.

Placeholders are banned: no “TBD”, no “add error handling”, no “similar to task 3”. Codex then checks the plan against the spec for gaps and mismatched names, and offers to run it either with a fresh subagent per task or inline with checkpoints.

When to use it

Use it after a design is agreed, often straight after the brainstorming skill. It suits work with several steps where you want each change small, tested and reviewable, or where other agents will carry out the plan.

Try it

Turn a spec into a plan
Use the writing-plans skill. Write an implementation plan for the spec in docs/superpowers/specs/ for team workspaces. Keep each task small enough to review on its own.

Does it work in Claude Code?

Yes. The Superpowers README lists Claude Code as a supported agent, installed from the official Claude plugin marketplace. Use that plugin rather than copying this folder, because the plan header and handoff name other Superpowers skills for running the plan.

Keep reading

An independent plugin for Codex. Not affiliated with or endorsed by OpenAI.