Agent skill · Jesse Vincent (obra)
Writing Plans
Communityname: writing-plans★ 305k (repo)pushed 2026-10-23MITSKILL.md on GitHubchecked 2026-10-24
Install
The skills CLI copies the skill into the folder of each agent you pick (Claude Code, Codex, Cursor, Copilot, Gemini CLI, OpenCode, Windsurf...). Add -g for all projects. Needs Node.js 22.20+. docs
npx skills add obra/superpowers --skill writing-plans
This repo is a plugin marketplace. Inside Claude Code, add it and install the plugin that holds the skill (superpowers), or copy only this skill into ~/.claude/skills. docs
/plugin marketplace add obra/superpowers /plugin install <plugin>@superpowers-dev # or only this skill: npx skills add obra/superpowers --skill writing-plans -a claude-code
Download the skill folder, zip it, then Customize > Skills > + > Create skill > Upload a skill. Code execution must be on (Settings > Capabilities). docs
git clone --depth 1 https://github.com/obra/superpowers.git /tmp/writing-plans-src cp -r /tmp/writing-plans-src/skills/writing-plans ./writing-plans zip -r writing-plans.zip writing-plans
Codex reads skills from .agents/skills in the repo or ~/.agents/skills. Type $ in Codex to use one. docs
npx skills add obra/superpowers --skill writing-plans -a codex
gh skill (GitHub CLI 2.90+, preview) installs it for Copilot in VS Code, the CLI and the cloud agent. Copilot also reads .github/skills and ~/.copilot/skills. docs
gh skill install obra/superpowers writing-plans
Cursor reads .cursor/skills, .agents/skills and ~/.cursor/skills (and .claude/skills). It does not install loose skills from a GitHub URL, so copy it in. docs
npx skills add obra/superpowers --skill writing-plans -a cursor
Installs from the GitHub repo; --path picks this skill out of the repo. Default scope is user (all projects). docs
gemini skills install https://github.com/obra/superpowers.git --path skills/writing-plans
OpenCode reads .opencode/skills, ~/.config/opencode/skills and the Claude and .agents folders. docs
npx skills add obra/superpowers --skill writing-plans -a opencode
Windsurf (now Devin Desktop) reads .devin/skills, .windsurf/skills and ~/.codeium/windsurf/skills. docs
npx skills add obra/superpowers --skill writing-plans -a windsurf
More from obra/superpowers
- Brainstorming: Makes the agent clarify goals and explore options with you before building anything new.
- Requesting Code Review: Has the agent get its finished work reviewed against requirements before merging.
- Subagent-Driven Development: Executes a plan by handing each task to a fresh subagent with review between steps.
- Systematic Debugging: A root-cause-first process for bugs and failing tests before any fix is attempted.
- Test-Driven Development: Enforces a red-green-refactor loop: write a failing test first, then the code.
- Using Git Worktrees: Sets up an isolated git worktree before feature work so the main checkout stays clean.
- Verification Before Completion: Requires running checks and showing their output before claiming work is done.
- Writing Skills: Method for writing and testing new skills so they trigger and behave reliably.
Other workflow & planning skills
- Skill Creator · Anthropic
- GitHub: Address PR Comments · OpenAI
- Skill Installer (Codex) · OpenAI
- Modern Python Tooling · Trail of Bits
- Commit (Sentry style) · Sentry
- Notion Spec to Implementation · Notion
- Git Commit · GitHub (community contributions)
FAQ
How do I install the writing-plans skill?+
Run npx skills add obra/superpowers --skill writing-plans and pick your agents, or use the tab for your agent above. In Claude Code the skill ends up in ~/.claude/skills/writing-plans/SKILL.md.
Which agents can use Writing Plans?+
Any agent that reads the Agent Skills format (SKILL.md): Claude Code, the Claude apps, Codex, GitHub Copilot, Cursor, Gemini CLI, OpenCode, Windsurf and more.
Who maintains Writing Plans?+
Jesse Vincent (obra) (a community project), in the obra/superpowers repo on GitHub, last pushed 2026-10-23.
Read a skill's SKILL.md and scripts before you install it: skills aren't verified by any agent vendor. All agent skills · MCP servers