dsh-superpowers
English | 中文
A DSH (DeepSeek Harness) port of obra/superpowers — the full multi-agent software-development methodology, available out of the box as native DSH skills.
Ported from upstream obra/superpowers (v6.3.0, by Jesse Vincent / Prime Radiant). Skill content is taken directly from upstream and mapped onto the DSH toolset.
Table of Contents
Features
- 14 methodology skills — brainstorm → plan → TDD → systematic debugging → code review → integrate.
- Native DSH skills — injected into
ctx.skills via a SkillProvider (rank 550; overridable by project/user skills).
- English (i18n) — skill content kept in original English; Chinese docs in
README.zh.md.
- Zero-build install —
lib/ is committed, so GitHub installs need no build step.
- Automated releases —
release-please (versioning + CHANGELOG + release notes) plus trusted publishing to npm and GitHub Packages.
Install
Using the web profile as the example (change --profile for others). Requires Node >= 20, pnpm >= 9, and dsh.
# From npm (recommended)
dsh plugin --profile web add @jasonfreelab/dsh-superpowers
# Local path install (dev / offline)
git clone https://github.com/JasonFreeLab/dsh-superpowers.git && cd dsh-superpowers
pnpm install && pnpm build
dsh plugin --profile web add ./
# Verify: you should see id: superpowers
dsh --profile web --dump-config | grep -A2 '@jasonfreelab/dsh-superpowers'
# Update / uninstall
dsh plugin --profile web add @jasonfreelab/dsh-superpowers
dsh plugin --profile web remove @jasonfreelab/dsh-superpowers
Also published to GitHub Packages (requires auth): npm.pkg.github.com/@jasonfreelab/dsh-superpowers.
Usage
In the DSH web UI
- Start the web UI and open the printed URL:
dsh web (alias of dsh --profile web).
- Start a new session. The 14 skills are registered automatically in
ctx.skills and appear in the model's <available_skills> catalog — no extra setup.
- The model loads the matching skill by itself via the
skill tool.
- You can also invoke a skill explicitly with
/skill-name, e.g. /superpower-brainstorming.
Typical flows
Build me X → superpower-brainstorming → superpower-writing-plans → superpower-subagent-driven-development
Fix this bug → superpower-systematic-debugging
Review this → superpower-requesting-code-review
Verify: inside a session await ctx.skills.list({cwd}) should return 14 entries with provider: superpowers.
Included skills
| Skill | When it triggers |
|---|
superpower-using-superpowers | Use when starting any conversation — establishes how to find and use skills, requiring skill invocation before ANY response including clarifying questions |
superpower-brainstorming | Use before any creative work — creating features, building components, adding functionality, or modifying behavior |
superpower-writing-plans | Use when you have a spec or requirements for a multi-step task, before touching code |
superpower-using-git-worktrees | Use when starting feature work that needs isolation from the current workspace, or before executing implementation plans |
superpower-executing-plans | Use when you have a written implementation plan to execute in a separate session with review checkpoints |
superpower-subagent-driven-development | Use when executing implementation plans with independent tasks in the current session |
superpower-dispatching-parallel-agents | Use when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies |
superpower-test-driven-development | Use when implementing any feature or bugfix, before writing implementation code |
superpower-systematic-debugging | Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes |
superpower-verification-before-completion | Use before claiming work is complete, fixed, or passing — run verification commands and confirm output before any success claim |
superpower-requesting-code-review | Use when completing tasks, implementing major features, or before merging |
superpower-receiving-code-review | Use when receiving code review feedback, before implementing suggestions |
superpower-finishing-a-development-branch | Use when implementation is complete, all tests pass, and you need to decide how to integrate the work |
superpower-writing-skills | Use when creating new skills, editing existing skills, or verifying skills work before deployment |
Tool mapping
Upstream references Claude Code tools; this package maps them onto DSH tools (see skills/superpower-using-superpowers/references/dsh-tools.md):
| Claude Code | DSH |
|---|
| Bash | bash |
| Read / Write / Edit | read / write / edit |
| Glob / Grep | glob / grep |
| TodoWrite | todo_write |
| Task (subagent) | subagent / subagent_fork |
| ExitPlanMode | exit_plan_mode |
| AskUserQuestion | ask_user_question |
| WebFetch / WebSearch | read_page / web_search |
| Load a skill | skill tool / /name gesture |
Layout
src/superpowers.ts # SkillProvider (rank 550), lazily loads SKILL.md bodies
skills/ # 14 skills (English, with references/)
lib/ # build output (committed for zero-build installs)
scripts/ # test.mjs + verify.mjs
cordis.patch.yml # bundle patch
.github/workflows/ # ci.yml + release.yml + release-please.yml
Development
pnpm install
npm run build # or: pnpm build
npm run typecheck
npm test # comprehensive (content hygiene + real SkillRegistry)
npm run verify # structural + runtime smoke
Contributing
Issues and pull requests are welcome. The upstream methodology lives in obra/superpowers.
License
MIT, matching upstream obra/superpowers (Jesse Vincent / Prime Radiant).
