playbook/brooks-lint/docs/dsh-setup.md

DeepSeek Harness (dsh) Setup

DeepSeek Harness (dsh) is DeepSeek AI's open-source agent harness — an "everything is a plugin" architecture with a Web UI, started with npx @deepseek-ai/dsh web. It natively loads Agent Skills and reads AGENTS.md, so all six brooks-lint modes run with no conversion.

Install

# simplest — one command (global)
curl -fsSL https://raw.githubusercontent.com/hyhmrright/brooks-lint/main/scripts/install.sh | bash -s -- dsh

# from a clone
./scripts/install.sh dsh            # global: ~/.dsh/skills (or $DSH_HOME/skills)
./scripts/install.sh dsh --project  # this repo: ./.dsh/skills

Prefer a manual copy? Clone the repo and cp -r skills/* ~/.dsh/skills/ — the contents, not the skills/ folder itself, so _shared/ lands as a sibling of the brooks-* folders.

dsh scans these skill roots, highest priority first, so an existing vendor-neutral install is picked up automatically:

Root	Notes
<projectRoot>/.dsh/skills	what --project writes
<projectRoot>/.agents/skills	shared with Cursor, Copilot, pi
$DSH_HOME/skills (default ~/.dsh/skills)	what the global install writes
$DSH_AGENTS_HOME/skills (default ~/.agents/skills)	./scripts/install.sh agents also covers dsh

The project root is the nearest ancestor containing .git; without one, dsh uses the current directory. When the same skill name appears in two roots, the higher one wins.

Invoke

Just ask — dsh routes to a skill from its description:

• "review this PR" → brooks-review
• "audit the architecture" → brooks-audit
• "where's our worst tech debt?" → brooks-debt

For explicit invocation, type / in the Web UI prompt and pick the skill, or type the token by hand: /brooks-review, /brooks-audit, /brooks-debt, /brooks-test, /brooks-health, /brooks-sweep. dsh recognises a whitespace-bounded /name anywhere in a message and injects that skill's body deterministically. The repo's AGENTS.md carries the Iron Law (Symptom → Source → Consequence → Remedy) and the Health Score rules; dsh also loads $DSH_HOME/AGENTS.md plus every AGENTS.md from the project root down to your working directory.

Notes

• Flat layout is mandatory (the installer guarantees it): discovery is one level deep (<root>/<name>/SKILL.md), never recursive, and the skills read ../_shared/, which only resolves when _shared/ sits beside the brooks-* folders. _shared/ itself has no SKILL.md, so dsh ignores it as a skill and the modes read it as ordinary files.
• dsh is in developer preview and warns of compatibility-breaking changes; the skill discovery contract above reflects packages/skill/skill-filesystem as of August 2026.
• 🧪 Documented per the official skills subsystem docs; community end-to-end verification welcome — open an issue.