dsh-skill-manager

A Skill Manager plugin for DeepSeek Harness (Web/Desktop):

• Pick skills BEFORE the conversation starts — the new-chat screen shows a
  "对话 Skill" chip above the composer: follow the workspace default, enable
  everything, or choose exactly which skills this conversation may load, then
  save before typing the first message.
• Global enable / disable — switch any skill off or on everywhere. Disabled
  skills disappear from the model's session skill catalog, from the / input
  trigger, and cannot be loaded by the skill tool or the /name gesture.
  Their files are never touched, so re-enabling restores them instantly.
• Per-workspace defaults for new conversations — pick "all available" or
  "only these skills" per workspace in Settings → Skill 管理. New
  conversations in that workspace start with exactly that selection.
• In-conversation management — the Skill button in the conversation
  header shows the current chat's effective skill set and lets you follow the
  workspace default, enable everything, or choose exactly which skills this
  chat may load. The session catalog republishes automatically on the next
  message ("对话中管理skill").
• Delete user skills — permanently remove a skill's files from
  ~/.dsh/skills / ~/.agents/skills (project, custom, and bundled skills
  are never deletable through this plugin).

How it works

The skill registry merges layers with the NEAREST scope winning a duplicate
name, and on the Web surface the filesystem provider is mounted by the agent
preset into the preset's STANDING scope layer. This plugin therefore registers
a shadow provider named skill-manager with rank 10 (below every shipped
provider rank) into each AGENT's own scope layer on agent/created — the
nearest layer of all — so its synthetic non-invocable candidates for every
effectively-disabled skill name always win that agent's catalog. The skill is
hidden from the model and the user without touching its files, and the
registration unwinds automatically when the agent is disposed.

The management surface never uses the plain registry read path (an unscoped
ctx.skills.list() sees only the global layer — empty on the Web surface):
listRealSkills() walks every layer (global + standing + agent) directly, so
the settings page shows the real catalog with real descriptions, invocation
flags, and paths. The "selected mode" complement uses that same cross-layer
universe.

State lives in one small JSON document:
<dshHome>/plugin-data/skill-manager/state.json.

Routes

Mutating routes require the x-dsh-skill-manager: 1 header (CSRF hardening).

Build / install

Pack the artifact (the tarball root holds a package/ directory):

tar -czf artifact.tgz package/

Install through the Harness plugin center, or manually: add the artifact as a
dependency of the profile's package.json ("dsh-skill-manager": "file:…/artifact.tgz"), append dsh-skill-manager to dsh.profile.bundles,
run pnpm install in the profile directory, then restart Harness.

Testing

The pure-logic suites (core, provider, state view, intro/detail) need nothing
but Node 22+:

node --test test/core.test.js test/provider.test.js test/stateview.test.js test/intro.test.js

The integration suite imports the harness's own cordis / dsh-skill /
dsh-scope packages, so point DSH_HOST_NODE_MODULES at a DeepSeek Harness
install's node_modules/@deepseek-ai directory first:

# Windows example
$env:DSH_HOST_NODE_MODULES = "$env:LOCALAPPDATA\Programs\@deepseek-aidsh-desktop\resources\host\node_modules\@deepseek-ai"
node --test test/integration.test.js

test/compose-check.mjs is a machine-specific offline check that composes the
live profile (DSH_PROFILE, DSH_HOME and DSH_HOST_NODE_MODULES can point
it at any profile) and asserts the skill-manager loader row is present.

Skill frontmatter metadata

The UI shows two Chinese introductions per skill, both read from the skill's
own SKILL.md frontmatter (the metadata object passes through untouched and
is never rendered into the model-facing catalog):

metadata:
  intro: <一句话中文简介，列表展示>
  detail: |-
    <详细中文介绍，详情弹窗展示：用途/适用场景/工作流程/典型触发语/产出物>

The bundled skill-intro-writer skill (see docs/ or your ~/.dsh/skills)
automates writing both fields whenever a new SKILL.md is generated.

License

MIT