Superpowers DeepSeek v4
Superpowers DeepSeek v4 is an agentic methodology and composable skills library for coding agents. It evolved from ideas in obra/superpowers but is maintained independently. Skills, hooks, install paths, and release cadence are not guaranteed to match the upstream project. Report issues and open pull requests in this repository if you use this variant.
Quickstart
Install for your harness: Claude Code · Codex CLI · Codex App · Factory Droid · Gemini CLI · OpenCode · Cursor · GitHub Copilot CLI
How it works
When you start building something, the agent does not immediately jump into code. It steps back, clarifies intent, and turns the conversation into a design you can read in sections. After you approve the design, it produces an implementation plan that a careful junior engineer could follow. It emphasizes red/green TDD, YAGNI, and DRY. When you say go, skills like subagent-driven-development drive execution with reviews and checkpoints. Skills are designed to trigger automatically—no manual “turn on superpowers” step.
Installation
Use this repository (gylove1994/superpowers-deepseek-v4) when copying install commands below. If you want the upstream obra/superpowers plugin instead, follow that project’s README; behavior and skills may differ.
Claude Code (this repo — recommended)
From a clone of this repository, register the local marketplace and install the project-scoped plugin (see .claude-plugin/marketplace.json):
cd /path/to/superpowers-deepseek-v4
/plugin marketplace add ./
/plugin install superpowers@gylove1994-superpowers-deepseek-v4 --scope project
Or add --scope user if you want it available in every project.
Upstream reference (official Superpowers plugin)
Anthropic’s catalog entry is not this fork. To install upstream Superpowers only:
/plugin install superpowers@claude-plugins-official
Codex CLI
Use the official Codex plugin marketplace. Search for Superpowers and install; confirm the package points at this repo if you intend to use DeepSeek v4–oriented skills.
/plugins
# search: superpowers
Codex App
Same marketplace as Codex CLI: Plugins → find Superpowers → install. Verify source matches the repository you intend.
Factory Droid
droid plugin marketplace add https://github.com/gylove1994/superpowers-deepseek-v4
droid plugin install superpowers@superpowers
(Adjust plugin id if your marketplace entry uses a different name.)
Gemini CLI
gemini extensions install https://github.com/gylove1994/superpowers-deepseek-v4
gemini extensions update superpowers
OpenCode
OpenCode has its own install path. Use the copy of this repo’s instructions:
Fetch and follow instructions from https://raw.githubusercontent.com/gylove1994/superpowers-deepseek-v4/main/.opencode/INSTALL.md
More detail: .opencode/INSTALL.md and docs/README.opencode.md.
Cursor
In Cursor Agent chat:
/add-plugin superpowers
Or search the marketplace for this project’s listing, if published.
GitHub Copilot CLI
The default community marketplace ships the upstream Superpowers plugin. To use this repository, add a marketplace or install path that references https://github.com/gylove1994/superpowers-deepseek-v4 (see GitHub Copilot CLI plugin docs for marketplace add / plugin install with a custom source). Example pattern if you mirror this repo into a marketplace entry:
copilot plugin marketplace add <YOUR_MARKETPLACE_OR_PATH_TO_THIS_REPO>
copilot plugin install superpowers@<YOUR_ENTRY>
Verify the resolved plugin URL points at this fork before relying on DeepSeek v4–oriented behavior.
The Basic Workflow
- brainstorming — Before code: questions, alternatives, design in readable chunks; saves the design doc.
- confirming-worktree-before-edit → using-git-worktrees — Session bootstrap (before using-superpowers): confirm worktree preference once per session before any project file write (source, spec, plan, config), then isolated branch/workspace and clean test baseline when accepted.
- writing-plans — Turns the approved design into small tasks with paths and verification.
- subagent-driven-development or executing-plans — Executes the plan with reviews or batch checkpoints.
- test-driven-development — RED–GREEN–REFACTOR; failures first, minimal code, then refactor.
- requesting-code-review — Between tasks; severity and blockers.
- finishing-a-development-branch — Done: tests, merge/PR/keep/discard, worktree cleanup.
