Agent skill

Superpowers Feature Workflow

by SYZ-Coder in SYZ-Coder/superpowers-openspec-team-skills

A skill your agent uses when feature work needs the Superpowers stages before or during implementation: brainstorming, design confirmation, implementation planning, worktree setup, test-driven…

MITAuto-check passedTesting & QA

Install Superpowers Feature Workflow

skills CLI
$ npx skills add SYZ-Coder/superpowers-openspec-team-skills --skill superpowers-feature-workflow -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install SYZ-Coder/superpowers-openspec-team-skills superpowers-feature-workflow --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/SYZ-Coder/superpowers-openspec-team-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/team-skills/superpowers-feature-workflow .claude/skills/superpowers-feature-workflow && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
superpowers-feature-workflow
GitHub stars
196
Token cost
~891 tokens
SKILL.md length
399 words
Files
5
Skills in repo
5
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when feature work needs the Superpowers stages before or during implementation: brainstorming, design confirmation, implementation planning, worktree setup, test-driven…

  • Works in 12 steps: Explore project context before proposing… → Clarify requirements one question at a… → Present 2-3 approaches with a… → …
  • Feature work needs the Superpowers stages before
  • SKILL.md covers Overview, Workflow, When to Use and Outputs, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Superpowers Feature Workflow is an agent skill from SYZ-Coder/superpowers-openspec-team-skills. Use when feature work needs the Superpowers stages before or during implementation: brainstorming, design confirmation, implementation planning, worktree setup, test-driven development, and verification. Trigger when the user asks to brainstorm first, wants a plan before coding, or wants disciplined execution with TDD and verification.

Its SKILL.md is about 890 tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files (for example `README.md`, `agents/openai.yaml` and `readme_cn.md`).

It sits in Testing & QA, covering Test-driven development, Brainstorming and Git worktrees. The repository describes itself as: 一套带有记忆和自学习的harness-team-skills企业级编程技能组合库 针对superpowers+openspec 进行按需组合使用,适用于个人与团队协作进行AI编程. The licence is MIT.

When your agent uses it

  • Feature work needs the Superpowers stages before
  • During implementation: brainstorming
  • Design confirmation
  • Implementation planning

Example prompts

  • “/superpowers-feature-workflow”

Workflow steps

12 steps, taken from the first numbered list in SKILL.md.

  1. Explore project context before proposing solutions. If .superpowers-memory/ exists, read PROJECT_CONTEXT.md, CURRENT_STATE.md…
  2. Clarify requirements one question at a time.
  3. Present 2-3 approaches with a recommendation.
  4. Write the approved design to docs/superpowers/specs/YYYY-MM-DD--design.md.
  5. Ask for user confirmation on the written design before moving on.
  6. Write the implementation plan to docs/superpowers/plans/YYYY-MM-DD-.md.
  7. Prefer a repo-local worktree for implementation.
  8. Implement with TDD: failing test first, then minimal code, then green.
  9. Run fresh verification commands before any completion claim.
  10. Before finishing the session, run a short memory closeout check: durable facts changed, current state changed, important decisions added…
  11. Prefer scripts/run-superpowers-memory-closeout.ps1 when you want one command to review the checklist, get update suggestions, and…
  12. Use scripts/suggest-superpowers-memory-updates.ps1 when the right memory surface is still unclear after implementation or verification.

What it can do on your machine

Read from SKILL.md and the folder at commit 1426ddc. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Superpowers Feature Workflow loads about 891 tokens when it runs. Until then it costs about 92 tokens; SKILL.md has 399 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~92
When it runs · the whole SKILL.md, loaded when a task matches
~891

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from SYZ-Coder/superpowers-openspec-team-skills at commit 1426ddc, republished under its MIT licence (© SYZ-Coder). 399 words, ~891 tokens.

Download SKILL.mdSave it as .claude/skills/superpowers-feature-workflow/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.
name
superpowers-feature-workflow
description
Use when feature work needs the Superpowers stages before or during implementation: brainstorming, design confirmation, implementation planning, worktree setup, test-driven development, and verification. Trigger when the user asks to brainstorm first, wants a plan before coding, or wants disciplined execution with TDD and verification.

Superpowers Feature Workflow

Overview

Use this skill for the Superpowers half of feature delivery. It covers clarification, design, plan, worktree, TDD, verification, and repo-persisted memory, but it does not manage OpenSpec artifacts.

This is an explicit opt-in workflow. Do not use it by default. Only use it when the user explicitly asks for this workflow, names this skill, or a repository policy explicitly requires it.

Workflow

  1. Explore project context before proposing solutions. If .superpowers-memory/ exists, read PROJECT_CONTEXT.md, CURRENT_STATE.md, DECISIONS.md, KNOWN_FAILURES.md, VERIFICATION_BASELINE.md, TEAM_PREFERENCES.md, USER_PROFILE.md, AGENT_NOTES.md, and the latest session journal entries first.
  2. Clarify requirements one question at a time.
  3. Present 2-3 approaches with a recommendation.
  4. Write the approved design to docs/superpowers/specs/YYYY-MM-DD-<topic>-design.md.
  5. Ask for user confirmation on the written design before moving on.
  6. Write the implementation plan to docs/superpowers/plans/YYYY-MM-DD-<topic>.md.
  7. Prefer a repo-local worktree for implementation.
  8. Implement with TDD: failing test first, then minimal code, then green.
  9. Run fresh verification commands before any completion claim.
  10. Before finishing the session, run a short memory closeout check: durable facts changed, current state changed, important decisions added, failure patterns discovered, verification rules changed, and reusable lessons identified.
  11. Prefer scripts/run-superpowers-memory-closeout.ps1 when you want one command to review the checklist, get update suggestions, and optionally run validation.
  12. Use scripts/suggest-superpowers-memory-updates.ps1 when the right memory surface is still unclear after implementation or verification.
  13. When the repo uses Superpowers memory, update the relevant memory files, including .superpowers-memory/CURRENT_STATE.md and a short session note under .superpowers-memory/session-journal/.
  14. When memory quality matters for the task, run scripts/validate-superpowers-memory.ps1 before the final completion claim.
Show full SKILL.md (138 more words)Show less

When to Use

  • The user explicitly asks to brainstorm first
  • The user explicitly names $superpowers-feature-workflow
  • The user explicitly asks for a written plan, TDD, or verification workflow
  • A repository policy explicitly requires this workflow

Outputs

  • Confirmed design doc
  • Implementation plan
  • Verified implementation evidence
  • Updated Superpowers memory when .superpowers-memory/ is present
  • Optional closeout helper output when the closeout helper was used
  • Memory validation evidence when memory updates were part of the workflow

Guardrails

  • Do not write production code before design approval
  • Do not skip the failing-test step for new behavior
  • Do not report success without fresh command output
  • Do not overwrite stable project memory with temporary notes; keep long-term facts in PROJECT_CONTEXT.md and session-specific updates in the journal
  • Do not leave new durable decisions, known failures, or verification rules only in chat history when the repo uses Superpowers memory

© SYZ-Coder, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 4 other files in team-skills/superpowers-feature-workflow of SYZ-Coder/superpowers-openspec-team-skills.

  • SKILL.md
  • README.md
  • agents/openai.yaml
  • readme_cn.md
  • workflow.yaml

Open the folder on GitHubat commit 1426ddc

Compare with similar skills

Superpowers Feature Workflow next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Superpowers Feature Workflow compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Superpowers Feature Workflow this skillSYZ-Coder/superpowers-openspec-team-skills196—~891Automated safety check: PassMIT
Nv Implementnovuhq/novu40k—~1.7kAutomated safety check: PassCustom licence
Ca FeaturearbiterForge/codeArbiter147—~2.2kAutomated safety check: PassAGPL-3.0
Evanflow Goevanklem/evanflow418—~2.3kAutomated safety check: PassCustom licence
Component Design With TdadHabitat-Thinking/ai-literacy-superpowers114—~3.3kAutomated safety check: PassCustom licence
Work Issuejoesaby/astro-mermaid123—~891Automated safety check: PassMIT

Similar skills

  • Nv Implement

    novuhq/novu

    Implement planned work by fanning out parallel subagents on isolated worktrees — TDD at pre-agreed seams, per-slice nv-park-and-review, merge back, full suite once at the end.

    40k GitHub stars~1.7k tokensUpdated today
    Testing & QAAuto-check passed
  • Ca Feature

    arbiterForge/codeArbiter

    Start a feature: brainstorm a spec, get it approved, then drive it test-first through the pipeline.

    147 GitHub stars~2.2k tokensUpdated yesterday
    Testing & QAAuto-check passed
  • Evanflow Go

    evanklem/evanflow

    Single entry-point orchestrator for the entire EvanFlow loop.

    418 GitHub stars~2.3k tokensUpdated 4 mo ago
    Testing & QAAuto-check passed
  • Component Design With Tdad

    Habitat-Thinking/ai-literacy-superpowers

    A skill your agent uses when designing a new plugin component (skill, agent, command, or backing script) for the ai-literacy-superpowers plugin or a sister plugin in this marketplace.

    114 GitHub stars~3.3k tokensUpdated 16 days ago
    Testing & QAAuto-check passed
  • Work Issue

    joesaby/astro-mermaid

    End-to-end workflow for resolving a GitHub issue in astro-mermaid — triages complexity, then runs brainstorm → TDD → implement → docs/spec → code review at the right depth.

    123 GitHub stars~891 tokensUpdated 2 mo ago
    DevelopmentAuto-check passed
  • Issue Resolve

    ffroliva/gflow-cli

    A skill your agent uses when an assessed gflow-cli issue (verdict CONFIRMED-BUG or LIKELY-BUG) has localized, verifiable scope and should be driven to a fix.

    261 GitHub stars~3.5k tokensUpdated today
    Testing & QAAuto-check passed

More from SYZ-Coder/superpowers-openspec-team-skills

  • Superpowers Openspec Superpowers Workflow

    SYZ-Coder/superpowers-openspec-team-skills

    A skill your agent uses when the user explicitly wants this workflow, wants Superpowers exploration before OpenSpec artifacts, or is confirming or continuing tasks that this workflow already…

    196 GitHub stars~2k tokensUpdated 3 mo ago
    Auto-check passed
  • Openspec Feature Workflow

    SYZ-Coder/superpowers-openspec-team-skills

    A skill your agent uses when a feature needs an OpenSpec change with proposal, design, specs, and tasks completed before coding.

    196 GitHub stars~462 tokensUpdated 3 mo ago
    Auto-check passed
  • Openspec Superpowers Workflow

    SYZ-Coder/superpowers-openspec-team-skills

    A skill your agent uses when the user explicitly wants an OpenSpec-first path that creates proposal, design, specs, and tasks before handing off to Superpowers execution, verification, and optional…

    196 GitHub stars~1.6k tokensUpdated 3 mo ago
    Auto-check passed
  • Superpowers Learning Workflow

    SYZ-Coder/superpowers-openspec-team-skills

    A skill your agent uses when the user explicitly wants to capture lessons from completed work, persist durable project knowledge, or turn repeated patterns into reusable learning notes for future…

    196 GitHub stars~1.2k tokensUpdated 3 mo ago
    Auto-check passed

Questions about Superpowers Feature Workflow

What does Superpowers Feature Workflow do?

A skill your agent uses when feature work needs the Superpowers stages before or during implementation: brainstorming, design confirmation, implementation planning, worktree setup, test-driven…. Superpowers Feature Workflow is an agent skill from SYZ-Coder/superpowers-openspec-team-skills. Use when feature work needs the Superpowers stages before or during implementation: brainstorming, design confirmation, implementation planning, worktree setup, test-driven development, and verification.

When should I use Superpowers Feature Workflow?

Superpowers Feature Workflow fits situations like: feature work needs the Superpowers stages before; during implementation: brainstorming; design confirmation; implementation planning.

How do I install Superpowers Feature Workflow in Claude Code?

Run `npx skills add SYZ-Coder/superpowers-openspec-team-skills --skill superpowers-feature-workflow -a claude-code`. Or copy the skill folder (team-skills/superpowers-feature-workflow in SYZ-Coder/superpowers-openspec-team-skills) into .claude/skills/superpowers-feature-workflow in your project. Claude Code loads it when a task matches its description.

How do I install Superpowers Feature Workflow in Codex?

Run `npx skills add SYZ-Coder/superpowers-openspec-team-skills --skill superpowers-feature-workflow -a codex`. Or copy the skill folder (team-skills/superpowers-feature-workflow in SYZ-Coder/superpowers-openspec-team-skills) into .agents/skills/superpowers-feature-workflow in your project. Codex loads it when a task matches its description.

Can I use Superpowers Feature Workflow in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add SYZ-Coder/superpowers-openspec-team-skills --skill superpowers-feature-workflow -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/superpowers-feature-workflow, .gemini/skills/superpowers-feature-workflow, .github/skills/superpowers-feature-workflow and .opencode/skills/superpowers-feature-workflow in your project.

What does Superpowers Feature Workflow need to run?

SKILL.md names no scripts, command-line tools or credentials: Superpowers Feature Workflow is instructions for the agent only.

Does Superpowers Feature Workflow access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Superpowers Feature Workflow safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Superpowers Feature Workflow use?

Superpowers Feature Workflow is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Superpowers Feature Workflow use?

About 891 tokens (SKILL.md is roughly 3.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Superpowers Feature Workflow?

Skills that share tags, products or a category with Superpowers Feature Workflow: Nv Implement (novuhq/novu, 40k stars), Ca Feature (arbiterForge/codeArbiter, 147 stars), Evanflow Go (evanklem/evanflow, 418 stars) and Component Design With Tdad (Habitat-Thinking/ai-literacy-superpowers, 114 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Superpowers Feature Workflow?

SYZ-Coder (a GitHub user) maintains it in SYZ-Coder/superpowers-openspec-team-skills, which has 196 GitHub stars. The repository holds 5 skills in this directory. The repository was last updated on June 12, 2026.

Source: SYZ-Coder/superpowers-openspec-team-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.