dsh-skills

---

description: "Skills manager for the DSH Web UI: a Skills panel in the left navigation that lists every installed Agent Skill, previews its instructions, enables or disables it, installs one from a folder, and restores what was uninstalled."

kind: "plugin-readme"

---

dsh-skills

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

A 技能 / Skills row in the DeepSeek Harness left navigation, and the page it opens.

[Install](#install) · [Download v0.1.0](https://github.com/yixin2021/dsh-skills/releases/latest) ·

[Landing page](https://yixin2021.github.io/dsh-skills/) (github.io is unreachable on some networks — see below)

DSH discovers Agent Skills from .dsh/skills and .agents/skills — under your

home and under a project — but ships no surface for seeing what is installed or

for turning one off without editing files. This plugin adds that surface.

What the panel does

| | |

|---|---|

| See everything | Every root DSH scans, with each skill's name, description, instruction path and invocation policy. |

| Preview | The full SKILL.md, frontmatter and body, without leaving the app. |

| Enable / disable | A switch per skill. Disabled skills keep their bytes and stay on disk. |

| Install | Copy a folder that has SKILL.md at its top level into the root you pick. The original is never moved. |

| Import from GitHub | Paste a GitHub repository, tree, or skill link. One repository can contribute several skills in one batch; conflicts and oversized bundles reject the whole batch without overwriting. |

| New skill | Write a bundle with a valid frontmatter block from a form. |

| Uninstall safely | Uninstall moves the entry to a root-local .trash; restore it later, or delete it for good. |

| Locate | Reveal a skill or a root in Finder / Explorer / the desktop file manager. |

| Known libraries | Codex, Claude Code, WorkBuddy and CodeBuddy keep their skills in well-known places; those that exist are listed automatically, each with that agent's mark. |

| Add a directory | Point the panel at another agent's skill library — ~/.claude/skills, a colleague's checkout, a shared bundle. Its skills are listed, managed in place, and loaded by DSH too. |

Install

From GitHub. This repository is a ready-to-install package: package.json

sits at the root and there is no build step, so any npm-compatible git spec

resolves. In the plugin manager (Settings → Plugins), install:

github:yixin2021/dsh-skills

The same spec works from the CLI — dsh plugin forwards its arguments to pnpm

inside the profile:

dsh plugin --profile desktop add github:yixin2021/dsh-skills
dsh plugin --profile desktop remove dsh-skills

https://github.com/yixin2021/dsh-skills and

git+ssh://git@github.com/yixin2021/dsh-skills.git are equivalent.

From a local checkout.

dsh plugin --profile desktop add /absolute/path/to/dsh-skills

The bundle patch inserts one Loader row named skills; the client half mounts

the navigation row and the panel. Reload the window after installing.

How it works

Host half (index.js) registers one authenticated JSON route,

POST /api/dsh-skills, on ctx.connection.fetch. It answers list, read,

set-disabled, trash, restore, purge, empty-trash, create,

import-directory, import-files, install-from-remote, reveal, add-root

and remove-root. ctx.skills.registerProvider publishes the

discovered libraries and the added directories to the model. lib/skills-core.js owns the

skill grammar — frontmatter parsing, root discovery, entry scanning — so the

route and the tests agree on what a skill is.

Client half (client.js) registers a sidebar.panellist icon under the id

dsh-skills and the main panel keyed by that same id, which is how the layout

addresses a panel. It never reads a skill root itself: every fact arrives

through the route, so the browser has no filesystem authority.

Importing from GitHub