dsh-local-skills
A DeepSeek Harness plugin that gives you a local SKILL browser in the web UI.
- 获取本地 skill — 扫描本地目录（默认
~/.dsh/local-skills，可用skillDirs配置更多目录），识别目录形式的/SKILL.md和扁平.md两种 skill 文件（带 YAML frontmatter）。 - 实时更新 — 用 chokidar 监听这些目录，skill 新增 / 修改 / 删除后，模型目录和网页 UI 都会实时刷新。
- 在网页查看 skill — 在 Settings（设置）里新增一个 Skills（技能） 页面，列出所有可用 skill 的名称、描述和适用场景。
- 使用按钮 — 每个 skill 都有「使用」按钮，点击后会告诉你如何让模型使用这个 skill（输入
/name或直接点名 skill），并可以一键复制示例提示。
Skill 文件格式
目录形式（推荐，可带资源文件）：
---
name: code-review
description: Review code for correctness, style, and security
whenToUse: When the user asks to review or audit a diff
# disable-model-invocation: true # 可选：禁止模型自动调用
# user-invocable: false # 可选：禁止用户直接调用
---
（这里是 skill 的正文说明）
扁平形式：直接把上面的内容保存为 code-review.md。
> name 必须是 kebab-case（小写字母、数字、连字符），如 code-review。
安装
dsh plugin --profile web add
安装后重启 web：
dsh web
配置
在 web 的 Plugins 设置页（或 cordis.patch.yml）里配置 local-skills：
skillDirs: 要扫描的额外目录（绝对路径或~开头的路径）；留空则默认扫描~/.dsh/local-skills。watch: 是否实时监听文件变化（默认true）。providerName: skill 的 provider 标签（默认local-skills）。
也可以在 ~/.dsh/profiles/web/cordis.patch.yml 里覆盖：
- id: local-skills
config:
skillDirs:
- ~/my-skills
- D:/work/skills
工作原理
- Host 半（
lib/index.js）：一个SkillProvider，注册进 host 的ctx.skills注册表；扫描目录 + chokidar 监听 +control.invalidate()实时失效。 - Client 半（
lib/client.js）：一个 Settings 区块，读取已有的skill.listAPI（它会合并 host 全局与当前 preset 作用域的 skill），每 3 秒轮询一次并订阅会话切换，实现实时展示。
平台兼容性（web / desktop / tui / headless）
- Host 半（
lib/index.js）是纯 Cordis 插件，只依赖ctx.skills（由dsh-base在任何 profile 都提供），因此天然兼容 web、desktop（内嵌 Web 界面的桌面 App）、tui、headless 等任意 profile —— 只要该 profile 装了本插件 bundle 且挂了dsh-skill就会生效，缺skills服务时只是不激活、不会崩。 - Client 半（
lib/client.js，dsh.client.platform: "web"）是浏览器 bundle，在 web 浏览器和任何以浏览器内核渲染的桌面端都会显示「设置 → 技能」页；纯终端（tui）没有浏览器 UI，不加载 client 半。 - 安装到任意 profile：
dsh plugin --profile add（pnpm 需要可用），或手动把包放进$DSH_HOME/profiles/node_modules并把包名加入该 profile 的dsh.profile.bundles。
[](https://skills.sh//)
