Skip to content

Repository files navigation

dsh-superpowers

English | 中文

dsh-superpowers banner

npm version npm downloads license Node.js

dsh-superpowers adds obra/superpowers support to DeepSeek Harness. It registers 14 skills for brainstorming, planning, TDD, debugging, and code review, and keeps the using-superpowers bootstrap active throughout the session.

Contents

Installation

From npm (recommended)

dsh plugin --profile web add dsh-superpowers

From GitHub

dsh plugin --profile web add "github:codeAnqiang-ma/dsh-superpowers#master"

After either command, stop and restart dsh web. Replace web with headless or a custom profile name when installing for a different surface, then restart that surface instead.

What it does

  • Registers all 14 Superpowers skills on ctx.skills. They appear in the skill catalog and load through the native skill tool. Nothing is copied into ~/.dsh/skills.
  • Adds the using-superpowers bootstrap as the superpowers:bootstrap prompt section at order 50. It is present on the first request and survives context compaction because it is part of the system prompt, not a one-off session message.
  • Maps Claude Code-style tool names such as Task, TodoWrite, and Bash/Read/Write/Edit to their DeepSeek Harness equivalents. The mapping also notes that hooks and slash commands are not available.

Verification

Check that the plugin is present in the profile:

dsh --profile web --dump-config

The output should contain id: superpowers followed by name: dsh-superpowers.

Then start a new session and ask for a feature. The agent should explore first and respond with questions or a design instead of writing code immediately. Its tool calls should include skill.

Configuration

Every field is optional. Override fields in the profile's own cordis.patch.yml:

- id: superpowers
  config:
    bootstrap: false
Field Default Description
skills true Register the bundled skills on ctx.skills.
bootstrap true Register the using-superpowers prompt section.
toolMapping true Append the DeepSeek Harness tool mapping to the bootstrap section.
order 50 Place the bootstrap after the persona (0) and before tool guidance (100–199).

Setting bootstrap: false keeps the skills discoverable but stops them from self-triggering; the model will use them only when it decides to consult the catalog.

Overhead

The bootstrap adds roughly 1.1k tokens (4,465 characters) to the system prompt of each request. The section is static and stays within the cached prefix. It is not appended as a new chat message on every turn. Set bootstrap: false to keep the skills without the fixed prompt overhead.

Requirements

  • DeepSeek Harness 0.1.0-rc.6 or newer
  • Node.js 22.19+ or 24+
  • Zero runtime dependencies; the plugin reaches the prompt and skill registries through ctx

Upstream and license

The skills under skills/ are vendored unmodified from obra/superpowers v6.3.0 at commit b36e082. The exact upstream version and commit are recorded in package.json. Report skill-behavior issues to the upstream repository and packaging issues to this repository.

The optional visual companion in brainstorming loads an upstream-hosted logo containing the Superpowers version. It sends no project or prompt content. Set SUPERPOWERS_DISABLE_TELEMETRY to a true value to disable it.

Two MIT license notices apply: the adapter is © its contributors under LICENSE, while the bundled skills are © Jesse Vincent and the Superpowers contributors under LICENSE.superpowers.

About

Superpowers (obra/superpowers) as a DeepSeek Harness plugin: the methodology skills plus their session bootstrap

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages