# dsh-mattpocock-skills

English | [中文](README.zh-CN.md)

[Matt Pocock's engineering skills](https://github.com/mattpocock/skills) — grilling, spec/ticket flows, TDD, code review, domain modelling — adapted for [DeepSeek Harness (dsh)](https://github.com/deepseek-harness). 25 skills, one install, every dsh session.

The bodies were rewritten for dsh's tool surface (`skill`, `subagent`, session commands) rather than Claude Code's; skill names and descriptions stay identical to upstream. See [PROVENANCE.md](PROVENANCE.md) for the pinned upstream commit and the per-skill adaptation log.

## Install

**Prerequisite**: the `dsh` CLI. Either install it globally once and use `dsh …` as written below:

```sh
npm install -g @deepseek-ai/dsh
```

or prefix every command with `npx -y @deepseek-ai/dsh` — no install, but the first run downloads the whole CLI and is slow.

### Option 1 — one command via `dsh plugin` (recommended)

```sh
dsh plugin --profile web add dsh-mattpocock-skills
# no global dsh installed? same command via npx:
npx -y @deepseek-ai/dsh plugin --profile web add dsh-mattpocock-skills
```

That is a pnpm install into the profile plus layer activation; verify with `dsh --profile web --dump-config` (a `# == dsh-mattpocock-skills` layer appears), then start a session on that profile. Works from npm, or from git:

```sh
dsh plugin --profile web add github:MynameisKcy/dsh-mattpocock-skills
```

The bundle carries its skills inside the package (a plugin registers them at rank 400), so nothing else is needed.

### Option 2 — drop into a skill root (no bundle, every profile)

```sh
git clone https://github.com/MynameisKcy/dsh-mattpocock-skills
cd dsh-mattpocock-skills
bash scripts/install.sh            # macOS / Linux / Git Bash → $DSH_HOME/skills (~/.dsh/skills)
# Windows PowerShell:
powershell -ExecutionPolicy Bypass -File scripts\install.ps1
```

Flags: `--user-agents` (install to `~/.agents/skills` instead — shared with other Agent-Skills harnesses), `--project <dir>` (this project only, `<dir>/.dsh/skills`), `--uninstall`, `--list`. New sessions pick the skills up immediately — dsh watches its skill roots.

Rank 400 (`~/.dsh/skills`) shadows an older copy of the same names in `~/.agents/skills` (rank 500), so this pack wins over any pre-existing upstream install. Use one channel; if you install both, the bundle and the directory copy will tie within the same layer.

### Option 3 — just ask your agent

Tell any dsh session:

> Install dsh-mattpocock-skills from GitHub.

The agent reads [AGENTS.md](AGENTS.md) in this repo and completes the install (clone + `scripts/install.sh`, or `dsh plugin add` if you prefer).

### Advanced — mount the clone without copying

Add to `$DSH_HOME/cordis.patch.yml` (the row's config is replaced whole, so restate everything you need):

```yaml
- id: skill-filesystem
  config:
    customSkillDirs: ["<absolute path to this clone>/skills"]
```

Or, for a web-profile preset that carries the skills: copy this repo's `skills/` into your preset directory and give that preset's `skill-filesystem` row `customSkillDirs: [!!js "process.getBuiltinModule('node:url').fileURLToPath(new URL('skills/', baseUrl))"]` — `baseUrl` is the preset's own directory.

## The 25 skills

**Flows (user-invoked — type `/name`)**

| Skill | What it does |
|---|---|
| `ask-matt` | Router: which skill or flow fits your situation |
| `grill-me` / `grill-with-docs` | Relentless interview to sharpen a plan; the docs variant persists to CONTEXT.md + ADRs |
| `to-spec` / `to-tickets` | Synthesize the conversation into a spec / tracer-bullet tickets with blocking edges |
| `implement` | Build a spec or ticket, driving TDD and ending in code review |
| `triage` | Move issues and external PRs through a triage state machine |
| `wayfinder` | Chart a huge foggy effort as decision tickets on the tracker |
| `improve-codebase-architecture` | Scan for deepening opportunities, HTML report, then grill the pick |
| `handoff` | Compact the conversation into a handoff document |
| `teach` | Multi-session teaching workspace |
| `to-questionnaire` | Turn an unanswerable decision into a questionnaire for someone else |
| `wait-what` | Re-pitch the last message in plain language |
| `setup-matt-pocock-skills` | One-time per-repo setup: issue tracker, triage labels, doc layout — run this first |

**Disciplines (model-invoked — the agent reaches for them, or you can ask by name)**

`grilling`, `tdd`, `code-review`, `domain-modeling`, `codebase-design`, `prototype`, `research`, `diagnosing-bugs`, `resolving-merge-conflicts`, `wizard`, `writing-for-agents`.

Start with `/ask-matt` after running `/setup-matt-pocock-skills` once in your repo.

## Development

```sh
node scripts/lint-skills.mjs   # validate every skill against the dsh format
```

Re-syncing from upstream is documented in [PROVENANCE.md](PROVENANCE.md).

## License

MIT — [Matt Pocock](https://github.com/mattpocock/skills) for the original skills; this repository's adaptations under the same license. See [LICENSE](LICENSE).