gongyijie85/mattpocock-skills-dsh

mattpocock-skills-dsh

Matt Pocock's skills for the DeepSeek Harness (DSH) — the full promoted set of mattpocock/skills (the "real engineering" skill collection behind aihero.dev/skills), ported to DSH's Cordis plugin architecture.

The plugin registers a skill provider on 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 via import.meta.url — an assembly fact of the package, never user config.

Unofficial port: skill content adapted from mattpocock/skills (MIT, © Matt Pocock). Upstream ships as a Claude Code plugin; this package is the DSH adaptation.

Quick start: the seven-lesson workflow

From Matt Pocock's skills email — the intended way to use this pack is to run this workflow end to end. Sandcastle is an external tool, not part of this package.

Prompts are disposable. Workflows are reusable. That is the whole difference, and these seven lessons are one workflow in the order you would actually run it:

Install & use in DeepSeek Harness

This is a DeepSeek Harness plugin bundle. After installing, the skills are registered in the host skill registry; every agent session in your profile can see them in the skill catalog and load them with the skill tool.

Prerequisites

• DeepSeek Harness installed, with pnpm — the dsh plugin command shells out to pnpm (check with pnpm --version; install from https://pnpm.io)

• The dsh CLI. It ships with the Harness, usually started via npx @deepseek-ai/dsh web. Either install it globally or prefix every command with npx:

  # Option 1: global install (recommended)
  npm install -g @deepseek-ai/dsh
  dsh --version
  
  # Option 2: no install, use npx everywhere
  npx @deepseek-ai/dsh --version
  

  Every dsh ... example below is equivalent to npx @deepseek-ai/dsh ....

One command, from GitHub

npx @deepseek-ai/dsh plugin --profile web add github:gongyijie85/mattpocock-skills-dsh

From npm

dsh plugin --profile web add mattpocock-skills-dsh

From a local folder (development)

# Folder installs are linked: edits take effect on the next profile restart
dsh plugin --profile web add D:\plugins\mattpocock-skills-dsh

Let DeepSeek Harness install it for you

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

Install the plugin from this link: https://github.com/gongyijie85/mattpocock-skills-dsh

The agent will run dsh plugin add → restart the profile → verify skill registration for you.

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). Confirm the layer composed:

dsh --profile web --dump-config     # must contain a `mattpocock-skills-dsh` row

The skills then appear in the agent skill catalog, loadable with the skill tool.

Uninstall

dsh plugin --profile web remove mattpocock-skills-dsh
# restart the profile afterwards

Skills (full 25 = the upstream promoted set)

productivity (7)

engineering (18)

Note: /clear and /compact are Claude Code native commands referenced by upstream, not skills in this pack. In DSH they map to "start a fresh session" and "carry the summary into a new session manually" — see the port note in skills/ask-matt/PHASE-BOUNDARIES.md.

Adaptation notes (vs upstream mattpocock/skills)

• Sync status: the 25 skill bodies track upstream — last full re-sync 2026-08-26 to mattpocock/skills 6654f6b (grilling round HR separator, wait-what CONTEXT-MAP.md guidance, to-tickets wide-refactor section). See CHANGELOG.md.
• Format: upstream already uses standard SKILL.md (YAML frontmatter: name + description, optional whenToUse), so DSH consumes it directly; bodies are essentially unchanged.
• Invocation semantics: upstream disable-model-invocation: true (user-invoked only, e.g. grill-me, wait-what) maps to DSH invocation.modelInvocable: false; everything else stays model+user.
• Tool naming: grill-me's "Call the Skill tool with 'grilling'" was adapted to DSH's skill tool; grilling's "dispatch a sub-agent" maps to the DSH subagent tool — the original wording was already generic, so it's unchanged.
• Dropped aux files: each skill's agents/openai.yaml is a Codex invocation policy DSH doesn't need; writing-for-agents's relative reference SKILL-MECHANICS.md ships with the package and resolves via resourceBase.
• Relative references: in-skill files (e.g. SKILL-MECHANICS.md) resolve through resourceBase, which points at the skill's own directory.

How it works

• Bundle layer — cordis.patch.yml inserts one row (- id: mattpocock-skills-dsh, name: mattpocock-skills-dsh) over the dsh-base layer. Later layers (profile cordis.patch.yml, --patch overlays) can still address this row by id.
• Provider — lib/index.js calls ctx.skills.registerProvider(...):
  • list() scans the package's skills/ directory, treating each <name>/SKILL.md as a candidate and parsing name, description, whenToUse and disable-model-invocation from the YAML frontmatter.
  • get() reads the winning candidate's body on demand and returns the full skill definition with resourceBase pointing at the skill directory.
• Zero runtime dependencies — Node built-ins only, consuming the injected ctx.skills service.

Adding your own skills

Drop a new skills/<kebab-name>/SKILL.md into the package — it must start with YAML frontmatter (name + description, optional whenToUse and disable-model-invocation). No code changes needed: list() discovers it automatically.

License

MIT. Skill content adapted from mattpocock/skills (MIT), © Matt Pocock; DSH port © mattpocock-skills-dsh contributors. See LICENSE.