Superpowers Writing Plans for Openclaw

A sophisticated planning skill that transforms high-level requirements into granular, test-driven implementation blueprints for AI agents.

axelhu
v1.0.1
Mar 26, 2026
0
2.1k
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install superpowers-writing-plans

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install superpowers-writing-plans using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is Superpowers Writing Plans?

Superpowers Writing Plans is a high-precision engineering skill designed for the Openclaw Skills ecosystem. It serves as a bridge between abstract brainstorming and concrete code execution, ensuring that AI agents follow a strict, disciplined development process. By assuming the executor has zero prior context, this skill forces the creation of comprehensive documentation that includes file mappings, interface definitions, and specific test cases before a single line of application code is written.

This skill enforces industry best practices such as Test-Driven Development (TDD), DRY (Don't Repeat Yourself), and YAGNI (You Ain't Gonna Need It). It eliminates ambiguity by banning placeholders like TBD or TODO, requiring instead full code blocks and command-line verification steps for every task. This level of detail ensures high-quality, maintainable code regardless of whether the plan is executed by a human or a sub-agent.

Superpowers Writing Plans Use Cases

  • Transforming a multi-step project specification into a sequence of bite-sized, actionable tasks.
  • Establishing a strict TDD workflow for complex feature development.
  • Organizing large-scale refactoring efforts by mapping file responsibilities and boundaries.
  • Creating hand-off documentation for sub-agents in a multi-agent Openclaw Skills environment.
  • Preventing technical debt by enforcing architectural consistency and functional isolation.

How Superpowers Writing Plans Works

  1. The agent announces the use of the writing-plans skill to set the operational context.
  2. It performs a scope check to ensure the specification is focused; complex systems are decomposed into independent sub-plans.
  3. A file structure mapping is created to define new files, modifications, and specific responsibilities for each unit.
  4. High-level goals are broken down into 2-5 minute granular tasks, specifically focusing on the Red-Green-Refactor TDD cycle.
  5. A self-review is conducted to verify specification coverage, eliminate placeholders, and ensure type/method consistency.
  6. The final implementation plan is saved to a specific markdown path within the repository.
  7. The agent provides a hand-off choice between sub-agent dispatching or sequential batch execution.

Superpowers Writing Plans Setup

To integrate this into your workflow, ensure your Openclaw environment is configured to access the superpower skill set. The skill operates within a feature branch workflow:

# Create a dedicated feature branch for the plan implementation
git checkout -b feature/your-feature-name

# The skill will then generate and save the plan to:
# docs/superpowers/plans/YYYY-MM-DD-feature-name.md

# After implementation, merge back to main
git checkout main && git merge feature/your-feature-name

Superpowers Writing Plans Data Schema & Taxonomy

The skill follows a strict metadata and file taxonomy to ensure all Openclaw Skills outputs are searchable and structured:

Field Description
Storage Path docs/superpowers/plans/
Naming Convention YYYY-MM-DD-<feature-name>.md
Header Template Includes Feature Name, Goal, Architecture, and Tech Stack
Task Schema File paths (with line numbers), Test code blocks, and Git commit commands
Verification Explicit 'Expected' versus 'Actual' terminal output patterns

Superpowers Writing Plans Advanced Features

  • Sub-Agent Dispatching: Integrated support for superpowers-subagent-dev to parallelize task execution.
  • TDD Enforcement: Automatically generates failing test snippets and CLI test commands for every unit of work.
  • Git Isolation: Native support for feature branch isolation and clean-up using superpowers-finishing-branch.
  • Automated Consistency Scanning: Built-in logic to detect name-mismatches between planned interfaces and subsequent tasks.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*