dsh-suite
dsh-suite banner
The DeepSeek Harness productivity suite: self-authored plugins + agent skills for DSH, installable in one command.
What's inside
| Piece | Type | What it does |
|---|
dsh-model-router | plugin | Virtual model ids routed over real provider/model candidates — priority failover, round-robin rotation, sleep windows |
deep-horizon | plugin | Injects the project's horizon (open gaps + about line) into every new session — cold-start project context shared across harnesses |
| strong-orchestrator | skill | Sequential implement → review-loop orchestration with a persistent implementer |
| dex / dex-plan | skills | Task hierarchies: epics, subtasks, verification via the dex CLI |
| ponytail (+ audit, debt, gain, help, review) | skills | Lazy-senior-dev output style family: shortest working diff wins |
What the one install command does — install, plugin registration, skills wired:
flowchart TD
install["dsh plugin --profile myprofile add github:andrepontesmelo/dsh-suite"] --> pkg["package installed: cordis.patch.yml, skills/, scripts/"]
pkg --> deps["plugin dependencies pulled: @andrepontesmelo/dsh-model-router + deep-horizon"]
deps --> patch["bundle patch inserts three rows into the profile"]
patch --> r1["model-router row: virtual model ids"]
patch --> r2["deep-horizon row: cold-start project context"]
patch --> r3["skill-suite row: dsh-skill-filesystem, customSkillDirs pointing at skills/"]
r1 --> live["restart the harness: plugins live, 9 skills wired"]
r2 --> live
r3 --> live
Install
Requires a DSH profile to install into.
dsh plugin --profile <profile> add github:andrepontesmelo/dsh-suite
That single command installs this package, pulls the plugin dependencies (currently @andrepontesmelo/dsh-model-router and deep-horizon), and registers the bundle patch — which points DSH skill discovery at the nine bundled skills. Restart the harness and every suite piece is live in that profile.
[!WARNING]
Installing this bundle registers nine agent skills into the target profile, and
every plugin you list is real software your prompts will flow through. Routes
and provider credentials stay yours — this bundle ships neither — but audit a
bundle you did not write before installing it, and pin the install (tag)
rather than floating on a branch.
Verify before installing:
npm test # structural check: 9 skills present, valid names/frontmatter, bundle wiring intact — run this pre-install check first
That check confirms what the install pulls per the files list in
package.json (cordis.patch.yml, skills/, scripts/, README.md,
LICENSE) plus the plugin dependencies. Both dependencies are pinned to
release tags (deep-horizon#v0.2.0, @andrepontesmelo/dsh-model-router#v0.2.1), so what an
install pulls cannot drift between installs — pin your install of this
bundle the same way (tag) rather than floating on a branch.
Useful commands once installed:
npm test # re-run the structural gate any time
dsh plugin --profile <profile> list # confirm model-router, deep-horizon, skill-suite rows
What the bundle patch inserts into your profile's composed config:
flowchart LR
subgraph bundle["dsh-suite cordis.patch.yml (ships in the bundle)"]
rows["insert rows:<br/>model-router<br/>deep-horizon<br/>skill-suite"]
end
subgraph profile["your profile config"]
p1["model-router: virtual model ids<br/>(your routes live here, never in the bundle)"]
p2["deep-horizon: cold-start project context"]
p3["skill-suite: dsh-skill-filesystem with<br/>customSkillDirs pointing at the<br/>bundle's skills/ directory"]
end
rows --> p1
rows --> p2
rows --> p3
Plugin configuration (model-router routes, provider credentials) stays yours: add route rows to your profile's cordis.patch.yml.
Companion pieces
Standalone siblings that don't ride in this bundle:
archloop — overnight architecture-improvement loop driverhkrc — Hermes Kanban blocker recovery controller
Docs
Start at the docs index:
- Architecture — bundle wiring, patch rows, skill discovery.
- Development — layout, the local gate, how to add a skill.
Contributing
PRs welcome — see CONTRIBUTING.md for the workflow and the local gate.
Security issues: SECURITY.md (do not open a public issue).
Validate
npm test # structural check: 9 skills present, valid names/frontmatter, bundle wiring intact
License
MIT — © 2026 André Pontes Melo
