<div align="center">

English | 简体中文

</div>

<div align="center">


</div>

superpowers-dsh

Superpowers for the DeepSeek Harness: a plugin bundle that ports the core skills of obra/superpowers (the Claude-Code skills library: TDD, debugging, planning, collaboration patterns) to DSH's Cordis plugin architecture.

The plugin registers a skill provider into the host layer of the ctx.skills registry, so every agent preset's scope chain merges these skills. Skill bodies ship inside the package (skills/<name>/SKILL.md) and are located from import.meta.url — an assembly fact of the package, never user configuration.

Install & use in your DeepSeek Harness

A plugin bundle for DeepSeek Harness (DSH). Installing it registers the 14 skills below into the host skill registry, so every agent session in your profile sees them in its skill catalog and can load them with the skill tool.

Prerequisites

• DeepSeek Harness, plus pnpm — the dsh plugin command forwards to pnpm

(pnpm --version to check; install from https://pnpm.io if missing)

• The dsh CLI. It ships with the Harness and is normally started as

npx @deepseek-ai/dsh web, so it is only on PATH inside that process tree. Either make it permanent, or use the npx form of every command below:

``sh # make dsh` permanently available (recommended): npm install -g @deepseek-ai/dsh dsh --version

# or skip the install and run everything through npx: npx @deepseek-ai/dsh --version ```

Every dsh ... example below works identically as npx @deepseek-ai/dsh ....

Simplest: one command

No global dsh install required. Run this from any directory:

npx @deepseek-ai/dsh plugin --profile web add github:LayneChai/superpowers-dsh

Then restart npx @deepseek-ai/dsh web (or dsh web) and refresh the browser.

Easiest: let the DeepSeek Harness agent install it

Open the DeepSeek Harness web UI, start a new conversation, and send this message:

Please install the plugin from this link: https://github.com/LayneChai/superpowers-dsh

The agent will run the install for you (dsh plugin --profile web add → restart the profile → verify the skills registered), so you never have to type a command. Afterwards you can ask it to run dsh --profile web --dump-config and confirm a superpowers-dsh row is present.

Install from npm (recommended — one command)

The package is published on npm as superpowers-dsh (synced to the npmmirror mirror for mainland China):

dsh plugin --profile web add superpowers-dsh

> Use the dsh plugin form — a plain npm install superpowers-dsh installs > the package as a library in the current directory but does not register > it into any DeepSeek Harness profile, so the skills would never load.

Install from GitHub

# from anywhere
dsh plugin --profile web add https://github.com/LayneChai/superpowers-dsh.git

Install from a tarball or a local folder

# tarball (e.g. the release asset superpowers-dsh-0.1.0.tgz)
dsh plugin --profile web add C:\path\to\superpowers-dsh-0.1.0.tgz

# or the unpacked package folder (pnpm links it, so edits take effect on restart)
dsh plugin --profile web add C:\path\to\superpowers-dsh

Restart and verify

The bundle layer mounts at profile startup, so restart the profile (stop and re-run dsh web / npx @deepseek-ai/dsh web, then refresh the browser). To confirm the layer is composed:

dsh --profile web --dump-config     # a `superpowers-dsh` row must be present

The skills then appear in the agent skill catalog (using-superpowers is the entry-point skill) and are loadable with the skill tool.

A successful install looks like this:


Using another profile (headless / tui / custom)

Point --profile at whichever profile you run:

dsh plugin --profile headless add superpowers-dsh
dsh --profile headless --dump-config

Uninstall

dsh plugin --profile web remove superpowers-dsh
# then restart the profile again

Notes

• Installers in mainland China can set the npm mirror first — it makes `dsh

plugin add superpowers-dsh fast: npm config set registry https://registry.npmmirror.com`

• A plugin installed from a folder or file: spec is linked, not copied:

changes to that folder take effect after the next profile restart.

• Consumers need no npm account and no 2FA — installing is a plain

package download.

Skills

How it works

• Bundle layer — cordis.patch.yml inserts one row

(- id: superpowers-dsh, name: superpowers-dsh) over the dsh-base layer. Later layers (the profile's cordis.patch.yml, --patch overlays) can still address that row by id.

• Provider — lib/index.js calls ctx.skills.registerProvider(...)

with a provider that: - list() scans the package's skills/ directory for <name>/SKILL.md bundles and returns candidates parsed from YAML frontmatter (name, description, whenToUse). - get() reads the winning candidate's body on demand and returns a full skill definition with resourceBase pointing at the skill's directory, so relative references (scripts, prompt templates) resolve.

• Zero runtime dependencies — the plugin imports only Node built-ins and

consumes the injected ctx.skills service interface.

Porting notes (vs. upstream obra/superpowers)

• Namespace prefixes removed: superpowers:brainstorming → brainstorming

(DSH skills are addressed by bare name).

• using-superpowers now documents the DSH skill tool and points at

skills/using-superpowers/references/dsh-tools.md, a full Claude-Code → DSH tool mapping (pwsh, subagent, workflow, goal, ...).

• Subagent references map to DSH's subagent / subagent_fork tools.
• brainstorming's visual companion adds a Windows note: the Node server

(scripts/server.cjs) runs everywhere; the .sh helpers are bash-only.

Adding your own skills

Drop a new skills/<kebab-name>/SKILL.md into this package — it must start with a YAML frontmatter block (name + description, optionally whenToUse). No code change needed: list() discovers it automatically.

License

MIT. Skill content adapted from obra/superpowers (MIT), © Jesse Vincent and contributors.