FeatherHunter/dsh-mattpocock-skills-deck

中文 · English

Part the fog of war, see the end — MattSkillsDeck handles the rest.
A playable task board for mattpocock/skills in DSH — visible, dispatchable, trackable.

Your ⭐ is the brightest star in my night sky.

👇 A mission board you can see, and act on.

Install in 30 seconds.

One prerequisite: DSH (DeepSeek Harness, an AI coding desktop). You give instructions, the AI does the work — and MattSkillsDeck turns that work into missions on a panel.

# ① Install the DSH CLI (skip if already installed)
npm install -g @deepseek-ai/dsh

# ② Install MattSkillsDeck — --profile is required: target the profile matching the DSH
#    entry you actually use (a wrong profile = the plugin never loads, restarts won't help)
dsh plugin --profile desktop add dsh-mattpocock-skills-deck   # DSH Desktop app (most users)
# dsh plugin --profile web add dsh-mattpocock-skills-deck     # self-started web server (dsh web)
# Pin to latest for extra stability (currently 1.7.38):
# dsh plugin --profile desktop add dsh-mattpocock-skills-deck@1.7.38 --registry https://registry.npmjs.org

# ③ That's it — the panel opens in DSH's own right sidebar (no third-party plugin needed)

One restart of the matching DSH entry and it works — zero config. Desktop app: fully quit and reopen DSH Desktop. Web server: restart dsh web, then refresh the page.

Opening the panel no longer makes you wait: click-to-visible content measured 5075 ms before, 193 ms after. That is a 2026-09-11 real-machine re-measurement; in the same record the commit phase went from 4948 ms to 117 ms. The fix turns the tag-packing and map-row fitting loops from a measure-then-write alternation into measure-first-then-write, so layout is no longer recomputed over and over. The rule and its evidence chain live in docs/adr/20260911-zero-layout-jitter.md.

Paste this to your AI — it will read the repo, check the environment, and install what's missing:

Please install the DeepSeek Harness plugin dsh-mattpocock-skills-deck (MattSkillsDeck).
Read the repo README first: https://github.com/FeatherHunter/dsh-mattpocock-skills-deck
First figure out which profile matches the DSH entry I actually use (DSH Desktop app → desktop; self-started web server → web) and install into that profile.
Then check the environment and install as needed (skip what's already installed), and report back briefly.

The examples below use the web profile — DSH Desktop app users: replace every --profile web with --profile desktop.

# Install a pinned version
dsh plugin --profile web add dsh-mattpocock-skills-deck@1.7.38 --registry https://registry.npmjs.org

# No global install (pin a version like above for extra safety)
npx --yes @deepseek-ai/dsh plugin --profile web add dsh-mattpocock-skills-deck

# When an update is silently skipped, point at the official registry
dsh plugin --profile web add dsh-mattpocock-skills-deck@latest --registry https://registry.npmjs.org

Upgrade · uninstall (desktop-profile users: replace --profile web with --profile desktop):

dsh plugin --profile web update dsh-mattpocock-skills-deck   # upgrade
dsh plugin --profile web remove dsh-mattpocock-skills-deck   # uninstall

Matt Pocock's skills are excellent: wayfinder draws a map and walks you through the fog to the goal. But once the map is drawn — how do you walk each step under your feet?

MattSkillsDeck adds a mission system on top of that map:

A mission board you can see — repo ISSUES stop being a flat log. MattSkillsDeck moves them into the DSH sidebar: open, blocked, closed in their own lanes, progress rings right where you glance.

A workbench that acts — every mission card is a button: diagnose, fix, run, new session. One click and the AI goes to work; how far it got, where it stalled, all written on the card.

The map owns the goal. MattSkillsDeck owns the steps.

👇 The task bar lives at the bottom of DSH: open, blocked, archived, handed off — one strip.

👇 Open an issue: description, author, one-click new session.

👇 Never touch the terminal: comment, respond to issues, run diagnostics in the panel.

👇 Far right of the task bar: every Matt skill, one click away.

Matt's official skills site (docs and tutorials): aihero.dev/skills

That's the pnpm supply-chain policy (minimumReleaseAge) in the DSH desktop app: freshly published versions are silently skipped by dsh plugin update and the marketplace's update button for a few hours. Fully quit DSH and reopen, then hard-refresh with Ctrl+F5. If it still hasn't updated, install explicitly from the official registry:

dsh plugin --profile web add dsh-mattpocock-skills-deck@latest --registry https://registry.npmjs.org

The mirror registry has not synced the new release yet: the error URL names a mirror (for example registry.npmmirror.com), while the new version is already published on the official registry — nothing failed to publish. Updating works again once the mirror finishes syncing. If you need the new version right away, install explicitly from the official registry (keep the trailing registry parameter in the command below — dropping it sends you back to the mirror):

dsh plugin --profile web add dsh-mattpocock-skills-deck@latest --registry https://registry.npmjs.org

Desktop app users: replace --profile web with --profile desktop.

Yes. The panel opens in DSH's own right sidebar: the mission list is on the left of that column and the details open beside it.

Want to see how the code is put together? This interactive diagram was generated by AI — it lays out the overall structure, data flow and key states, with dark and light themes and image export.

Open online (recommended) · or just open architecture/MattSkills-architecture.html locally in your browser — no server needed. The source data lives next to it as mattskills.architecture.json, with more write-ups in the *.md files in the same folder.

Edit src/ only — client.js, host.js at the repo root and package/lib/ are build artifacts, don't touch them.

node scripts/build.mjs      # build
npm run test:smoke          # smoke tests
npm run verify              # contract checks
bash scripts/build.sh       # build + sync into an installed DSH

The full build / verify / sync / publish workflow lives in DEV-WORKFLOW.md.

If you like this plugin, these might help too:

dsh-opencode-palette — 34 classic opencode themes for DSH, one click, persisted across restarts

dsh-prompt — A prompt toolbox: 24 deep templates a click away, stop copy-pasting

dsh-chinese-skill-patch — Use Chinese skill names in DSH directly: type /私 to reach 私家大厨, no English renaming needed

---

Questions or ideas? Open an issue or start a thread in discussions

A personal project, not affiliated with mattpocock/skills. MIT © FeatherHunter

Thanks to everyone who opened an issue, sent a PR, or joined a discussion — you made this plugin better bit by bit.

@pioneerAlone — reported #298 (duplicate details/better-sidebar with clear repro), #274, #234, #645 (update failure caused by mirror lag) and opened PRs #273 (its root-cause analysis was absorbed into v1.7.3) and #316 (merged) — thanks for making the reinstall experience smooth again 🌹🌹🌹🌹🌹🌹

@Shimmernight — filed #277 and PRs #287, #275, #106 🌹🌹🌹🌹

@21967201 — opened PR #321 (triage + wayfinder labels docs) 🌹

@angenet — reported #295, #262 on macOS checks 🌹🌹

@hyperion2144 — reported #110 and more 🌹

@tafcear — reported #422 (a quieter statusbar for non-coding workspaces) — thanks for freeing non-coding workspaces from the setup banner 🌹

@271912980 — suggested in #257 that sessions become stable, addressable endpoints (session ID + semantic name)

@xiSage — reported #435 (self-hosted GitLab repos not recognized) and started discussion #436 (turning the plugin off for one workspace) 🌹

@dis0neplay — opened PR #493 (fix CI and the Pages root redirect; closed at the requester's direction) 🌹

@snmtg1008 — left a self-tested fix for the false "local data directory is not writable" report on #476

@arnold117 — reported #574 (in the local Markdown backend several work units collided under one number, so only the first was visible and comments landed in the wrong file) and opened PR #575, which fixed it (merged) — thanks for letting multiple work units in one repo read and write their own files 🌹🌹

@SbDonger — reported #640 (statusbar and input box misaligned, leaving a wide band above the input) 🌹

And thanks to everyone who left thoughts in comments and discussions. If you hit a problem or have an idea, feel free to open an issue or start a discussion.

Scan to join the topic group — QR code never expires. Casual chat in the group, bugs and feature requests via Issues for better traceability.