dsh-skills-hub
中文版: README.zh.md
Cross-platform AI Skills manager for the DeepSeek Harness (DSH).
Install one skill from the central skills library ~/.agents/skills into multiple agent tools (Claude Code, Cursor, Codex, Gemini CLI, Trae, Windsurf, Qoder, CodeBuddy, ...) via system symbolic links — one source of truth driving many coding agents.
One source of truth, driving many AI coding tools.
Supported Operating Systems
| OS | Link type | Privileges |
|---|
| Windows | Directory Junction | No admin required |
| macOS | Directory symlink | No admin required |
| Linux | Directory symlink | No admin required |
Zero third-party runtime dependencies (Node.js built-ins only). DSH runs on Windows / macOS / Linux, so this plugin works across all three.
Features
- Central skills library management over
~/.agents/skills.
- Only installed platforms are shown: 26 common agent tool directory mappings are built in; scan filters to what actually exists on this machine.
- One-click install of any central skill into an agent platform via symbolic links (no admin rights required).
- Uninstall semantics:
- Link entry (pointing at the central library) → remove the link only, keep the data source.
- Local skill (the agent tool's own real directory) → delete that platform's data source.
- Read-only platforms (e.g. Claude Code) are shown without write actions.
- Custom platforms: add any local skills directory in Settings, persisted to
~/.skillsmanage/config.json.
- Local-first, no database: metadata is scanned live from the filesystem.
Screenshots
Settings → 技能中心 (Skills Hub) — the central skills library and platform cards, grouped by category; only platforms installed on this machine are shown.
管理入口
Install a central skill into a platform — a link is created pointing back to the central library:
安装新技能
Uninstall a link entry — removes the link only, the central data source stays untouched:
卸载技能
Delete a local skill — removes that platform's own data source:
删除技能
Requirements
| Requirement | Minimum |
|---|
| OS | Windows / macOS / Linux |
| Node.js | >= 20 (engines in package.json) |
| DSH (DeepSeek Harness) | installed, dsh command on PATH |
| pnpm | installed (used by dsh plugin internally) |
The plugin itself runs with zero runtime dependencies; Node.js is provided by the DSH host process.
Install
Prerequisites
Option 1: One-click install script (recommended)
Run inside the repository root:
Windows (PowerShell)
powershell -ExecutionPolicy Bypass -File scripts/install.ps1
# or
pwsh scripts/install.ps1
macOS / Linux
bash scripts/install.sh
The script runs dsh plugin --profile web add <this directory> — pnpm-installs and mounts the plugin automatically; no manual configuration.
Option 2: dsh plugin add
From local source (in the repository root):
dsh plugin --profile web add .
From npm (once published):
dsh plugin --profile web add dsh-skills-hub
dsh plugin add automatically appends packages that declare dsh.bundle.patch to dsh.profile.bundles and applies the plugin's own cordis.patch.yml — no manual profile edits. Re-run the same command to upgrade.
Option 3: Manual (development)
# 1. Edit ~/.dsh/profiles/web/package.json
# add to dependencies: "dsh-skills-hub": "link:<absolute path>"
# 2. Install in the profile directory
cd ~/.dsh/profiles/web
pnpm install
After any install method, restart DSH for the plugin to take effect.
Usage
Open DSH Settings → 技能中心 (Skills Hub):
- Platforms are grouped by category (Central / Coding / Lobster / Custom); only platforms actually installed on this machine are shown.
- The central library card lists all available skills (data source, never deleted).
- Each agent platform card lists its skills (badged "link" vs "local") with an install dropdown:
- Link entry → 「卸载」(uninstall) button (removes the link only).
- Local entry → 「删除」(delete) button (deletes that platform's data source).
- Add custom platforms at the bottom (directory path + optional display name).
Platform Mapping
Built-in mapping (conventional directories; only platforms that exist on this machine are displayed):
| Category | Platform | Skills directory | Writable |
|---|
| Central | Central library | ~/.agents/skills | data source |
| Coding | Claude Code | ~/.claude/skills | read-only |
| Coding | Codex CLI | ~/.codex/skills | ✅ (excludes .system) |
| Coding | Cursor | ~/.cursor/skills-cursor | ✅ |
| Coding | Gemini CLI | ~/.gemini/skills | ✅ |
| Coding | Trae | ~/.trae/skills | ✅ |
| Coding | Factory Droid | ~/.factory/skills | ✅ |
| Coding | Junie | ~/.junie/skills | ✅ |
| Coding | Qwen | ~/.qwen/skills | ✅ |
| Coding | Trae CN | ~/.trae-cn/skills | ✅ |
| Coding | Windsurf | ~/.windsurf/skills | ✅ |
| Coding | Qoder | ~/.qoder/skills | ✅ |
| Coding | Augment | ~/.augment/skills | ✅ |
| Coding | OpenCode | ~/.opencode/skills | ✅ |
| Coding | KiloCode | ~/.kilocode/skills | ✅ |
| Coding | OB1 | ~/.ob1/skills | ✅ |
| Coding | Amp | ~/.amp/skills | ✅ |
| Coding | Kiro | ~/.kiro/skills | ✅ |
| Coding | CodeBuddy | ~/.codebuddy/skills | ✅ |
| Coding | Hermes | ~/.hermes/skills |
The built-in mapping lives in the PLATFORMS constant in lib/index.js — edit it to add/remove platforms, or add custom platforms in the Settings UI (persisted to ~/.skillsmanage/config.json).
Project Structure
dsh-skills-hub/
├── package.json # plugin manifest (dsh.client / dsh.bundle.patch)
├── cordis.patch.yml # bundle patch (insert entry, applied automatically by dsh plugin add)
├── lib/
│ ├── index.js # Host half: node:fs symlinks + webServer routes
│ └── client.js # Client half: settings UI (__ModuleLoader__.load)
├── scripts/
│ ├── install.ps1 # Windows one-click install script
│ └── install.sh # macOS / Linux one-click install script
├── test/core.test.js # unit tests (link primitives + uninstall semantics + cross-platform link type)
├── README.md # this file (English)
├── README.zh.md # Chinese translation
├── LICENSE
└── CHANGELOG.md
Security
- Write endpoints accept loopback Host only (
localhost / 127.0.0.1) and require a custom marker header (DNS rebinding protection).
- Skill names are whitelisted
[a-zA-Z0-9._-] (no path traversal).
- The central library itself is never deleted; link removal never touches the data source.
- Deleting a local real directory is an explicit user action, shown as a red 「删除」 button distinct from link 「卸载」.
License
MIT
