superpowers-writing-plans

superpowers-writing-plans is a skill for Claude Code, Codex from christopherarter/superpowers-reasonix. It costs 24 tokens per session (1,539 once invoked), scanned A, original, MIT.

A planning guide for turning a detailed software specification into a sequence of small implementation tasks. TDD means writing tests before or alongside code, and DRY means avoiding repeated logic.

In plain words
What is it for?
Use it before implementing a multi-step feature to map the codebase, split the work into testable tasks, identify files to change, and save an implementation plan.
Why use it?
It prevents large requirements from becoming vague or hard-to-test coding work. The plan records affected files, checks, documentation, and testing instructions for an engineer with little project context.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one. Also seen: mentions subagents.

Good fit Use it before implementing a multi-step feature to map the codebase, split the work into testable tasks, identify files to change, and save an implementation plan.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/christopherarter/superpowers-reasonix/superpowers-writing-plans
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add christopherarter/superpowers-reasonix --skill superpowers-writing-plans
Clone the repo
git clone --depth 1 https://github.com/christopherarter/superpowers-reasonix

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for superpowers-writing-plans

README.md
[![agentmods](https://agentmods.dev/badge/skills/christopherarter/superpowers-reasonix/superpowers-writing-plans/github.svg)](https://agentmods.dev/skills/christopherarter/superpowers-reasonix/superpowers-writing-plans)
Your own site
<a href="https://agentmods.dev/skills/christopherarter/superpowers-reasonix/superpowers-writing-plans"><img src="https://agentmods.dev/badge/skills/christopherarter/superpowers-reasonix/superpowers-writing-plans/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for superpowers-writing-plans

Your own site · 80×15
<a href="https://agentmods.dev/skills/christopherarter/superpowers-reasonix/superpowers-writing-plans"><img src="https://agentmods.dev/badge/skills/christopherarter/superpowers-reasonix/superpowers-writing-plans.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 24 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,539 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe. Third-party audits
  • NVIDIA SkillSpector pass 7 Sept 2026
How audits are shown
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00024 $0.01539
Opus 5 $0.00012 $0.00770
Sonnet 5 $0.00005 $0.00308
Haiku 4.5 $0.00002 $0.00154

Measured 10d ago against content hash e1ed5d7d9dda, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-10, from the pricing page.

Security

Grade A, and why

superpowers-writing-plans scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 10d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/superpowers-writing-plans/SKILL.md · 153 lines

How it starts

The opening of the file, as written. The whole thing — 153 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Writing Plans

Overview

Write plans for an engineer with zero codebase context and questionable taste. Document everything: files per task, code, testing, docs to check, how to test. Whole plan as bite-sized tasks. DRY. YAGNI. TDD. Frequent commits.

Skilled, but knows almost nothing about our toolset or domain. Assume weak test design.

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

Context: Isolated worktree? Created via the superpowers-using-git-worktrees skill at execution time.

Save plans to: docs/reasonix/plans/YYYY-MM-DD-<feature-name>.md

  • (User plan-location preferences override this default)

Scope Check

Spec spans multiple independent subsystems? Should have been split into sub-project specs during superpowers-brainstorming. If not, suggest separate plans — one per subsystem. Each plan produces working, testable software on its own.

File Structure

Before tasks, map which files get created/modified and each one's responsibility. Decomposition locks in here.

  • Clear boundaries, well-defined interfaces. One responsibility per file.
  • You reason best about code held in context at once; focused files = reliable edits. Prefer small, focused files.
  • Files that change together live together. Split by responsibility, not technical layer.
  • Existing codebases: follow established patterns. Modifying an unwieldy file? Planning a split is fine.

Bite-Sized Task Granularity

Each step = one action (2-5 minutes):

  • "Write the failing test" — step
  • "Run it to make sure it fails" — step
  • "Implement the minimal code to make the test pass" — step
  • "Run the tests and make sure they pass" — step
  • "Commit" — step

Plan Document Header

Every plan MUST start with this header:

# [Feature Name] Implementation Plan

> **For agentic workers:** implement this plan task-by-task — dispatch a fresh subagent per task with the native `task` tool (recommended for quality), or use the superpowers-executing-plans skill to work through it inline. Steps use checkbox (`- [ ]`) syntax for tracking.

**Goal:** [One sentence describing what this builds]

**Architecture:** [2-3 sentences about approach]

**Tech Stack:** [Key technologies/libraries]

---

Read the full file on GitHub · 153 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 10d ago First seen · 153 lines · 24 tokens per session scan A e1ed5d7d9dda

Subscribe to this mod's changes

superpowers-writing-plans is a skill published in the GitHub repository christopherarter/superpowers-reasonix (98 stars, last pushed 20d ago), licensed MIT. It adds 24 tokens to every session and 1,539 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

skill-creator

Create new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.

CherryHQ/cherry-studio · 64 tokens

gh-pr-review

Automated Cherry Studio review for local branches, PRs, commits, files, architecture docs, and repository skills. Use for code or documentation reviews that need project-specific naming, main/renderer/shared placement and dependency rules, IpcApi and DataApi boundaries, lifecycle/service ownership, renderer hooks…

CherryHQ/cherry-studio · 147 tokens

prepare-release

Prepare a new release by collecting commits, generating bilingual release notes, updating version files, and creating a release branch. Use when asked to prepare/create a release, bump version, or run /prepare-release.

CherryHQ/cherry-studio · 44 tokens

claude-automation-recommender

Analyze a codebase and recommend Claude Code automations (hooks, subagents, skills, plugins, MCP servers). Use when user asks for automation recommendations, wants to optimize their Claude Code setup, mentions improving Claude Code workflows, asks how to first set up Claude Code for a project, or wants to know what…

CherryHQ/cherry-studio · 77 tokens

gh-create-pr

Create or update GitHub pull requests using the repository-required workflow and template compliance. Use when asked to create/open/update a PR so the assistant reads .github/pullrequesttemplate.md, fills every template section, preserves markdown structure exactly, and marks missing data as N/A or None instead of…

CherryHQ/cherry-studio · 65 tokens

vercel-react-best-practices

React and Next.js performance optimization guidelines from Vercel Engineering. This skill should be used when writing, reviewing, or refactoring React/Next.js code to ensure optimal performance patterns. Triggers on tasks involving React components, Next.js pages, data fetching, bundle optimization, or performance…

CherryHQ/cherry-studio · 67 tokens