DSH Skills Manager

DSH Skills Manager is a community-maintained DeepSeek Harness (DSH) plugin, not an official DeepSeek AI product.

This README describes 1.2.18. Released changes are in the changelog.

Bring skills from your computer and projects into DSH without switching between Agent folders.

• Unified multi-view management: Browse Global Skills, Project Skills, Discover, and Trash in unified tabs with instant search, status filtering, and collapsible source groups.
• Broad ecosystem support: Full coverage for 20+ tools and CLI environments including DSH, Shared Agent, Codex, Claude Code, Copilot, Cursor, Google Antigravity, Windsurf, Qoder, and Trae without touching third-party files.
• Categorization and drag & drop: Create category folders inside sources, drag skill rows (⋮⋮) to organize and order them, batch assign skills, and toggle entire categories with a single switch. Category metadata is saved without moving files.
• Public markets & repositories: Integrated Discover hub to explore trending skills from ClawHub and skills.sh, or subscribe to public GitHub repositories with incremental diff inspection and backups.
• Create and flexible import: Create skills or import ZIP archives, folders, and SKILL.md files directly into your global user root or a registered workspace.
• Wide reading experience: 760px responsive detail modal with monospace syntax styling, vertical resizing, and a one-click "Copy body" action.
• Trash & safe rollback: Soft delete protects skills from accidental loss, allowing complete restoration with provenance and update history preserved.

Global skills:

Project skills:

Skill repositories & discover:

Screenshots show core feature views for global skills, project skills, and skill discovery. Lossless WebP.

Requires a working DeepSeek Harness installation. The commands below use the web profile; replace it with yours if needed.

Supported plugin installation sources are the npm registry, a locally built .tgz package, and GitHub. GitHub and npm both include a ready-to-run lib. After changing source, run the build before committing.

Send this to an agent that can use your local terminal:

Install the latest @michengai/dsh-skills-manager into my DSH web profile using the official npm registry. Confirm installation and explain how to reload DSH.

[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
$OutputEncoding = [System.Text.Encoding]::UTF8
dsh plugin --profile web add @michengai/dsh-skills-manager@latest --registry=https://registry.npmjs.org/

Restart DSH, refresh the page, and open Settings → Skills. To update, select Check for updates or run the installation command again.

• Plugin 1.2.18 is tested with DeepSeek Harness 0.2.0-rc.1, 0.2.0-rc.2, 0.2.1-rc.1, 0.2.1-rc.2, 0.2.1-rc.3.
• Host compatibility: Full DeepSeek Harness 0.2.x line (>=0.2.0-rc.1 <0.3.0-0), forwards-compatible with subsequent 0.2.x releases, alphas, and RCs without requiring routine plugin version bumps. Legacy versions and breaking changes in the 0.3.0 generation are rejected by the version gate. If you still use a 0.1.x host, install plugin 1.1.23 instead of @latest.
• Reverse proxy deployment: Supports hosting DSH behind prefix-stripping reverse proxies (e.g. /app/dsh/). API and update endpoints resolve against the page base URI (document.baseURI).

The plugin follows standard DSH bundle configuration conventions. Options are located at:

Sidebar → Plugins → Click Skills Manager (the host's plugins.bundle.config slot).

Two native switches are available:

• Default: Disabled (false)
• Description: Displays a persistent Skills navigation icon directly under Plugins in the host's left primary sidebar.
• Effect:
  • When enabled, clicking the sidebar icon opens the Skills Manager directly in the primary workspace with a 960px centered container (matching host plugin manager conventions). This eliminates vertical scrolling constraints in narrow settings dialogs;
  • When disabled, unregisters the sidebar entry cleanly;
  • The standard Settings → Skills view remains active either way, and state is synchronized live across both entry points.

• Default: Enabled (true)
• Description: Controls whether the plugin checks for and installs updates from npm.
• Effect:
  • Dynamic UI Sync: Disabling the toggle hides the Check for updates button in the header immediately without requiring a full page reload;
  • Endpoint Guard: When disabled, the update API route returns HTTP 403 for all check and install requests, preventing unreviewed updates;
  • Host / Platform Lock: For curated plugin indexes (such as VibeDev) or restricted enterprise environments, this can be locked directly via Cordis configuration (bundle patch) without needing UI interaction:

    updater: false # or onlineUpdate: false

    Once configured, the built-in updater is disabled at startup and the update action stays hidden.

1. Global Skills
   • Manage cross-project skills stored across all detected agent home directories on your machine.
   • Categorize and toggle skills by source; same-name precedence automatically highlights shadowed copies.
2. Project Skills
   • Select any registered workspace from the dropdown to manage its project-level skills (<project>/.dsh/skills, etc.).
   • Scans and searches only the selected workspace; project copies take precedence over global counterparts.
3. Discover
   • Public Catalogs: Direct integration with ClawHub and skills.sh to find and install popular community skills;
   • GitHub Repositories: Subscribe to public repositories, scan skill lists, preview diffs, and install copies with local edit protections.
4. Trash
   • Soft-delete buffer for DSH and Shared Agent skills, preserving provenance and install destinations.
   • Deleted skills can be restored anytime with a single click.

The DeepSeek Harness loader enforces strict identifier policies:

• Format constraint: Host loaders require skill names to strictly match lowercase ASCII alphanumeric characters and hyphens (kebab-case, e.g. my-tool).
• Non-ASCII & Chinese skill folders: Your skill directory name can remain in Chinese (e.g. 文案排版/), provided you specify a valid English name in SKILL.md frontmatter:

  ---
  name: copy-formatting-helper
  description: Helper for multi-platform article formatting
  ---
  
  # Skill instructions...

• Diagnostics: Skills lacking an English name are flagged with clear in-app diagnostics explaining that the host loader cannot invoke them, with options to safely disable or clean up records.

• The header Check for updates updates the plugin itself; repository Refresh checks subscribed skill contents without replacing local files.
• Repository installation can target user DSH skills, Shared Agent (~/.agents/skills, overridable via DSH_AGENTS_HOME), or <project>/.dsh/skills for registered workspaces. Unsafe paths and external agent roots (Codex, Claude) are locked against writes.
• 32 MiB archive limit; downloading subdirectories still fetches the full archive.
• Local edits are detected and require explicit confirmation before overwriting; backup history is preserved for rollback.

~ means your home directory; <project> is the project root of a registered workspace. These are default paths; configured environment variables take precedence. An environment variable overrides the agent's main home root directory, and the plugin scans the skills folder under it (i.e., <ENV_PATH>/skills).

Source	Global directory	Environment variable	Project directory
DSH	~/.dsh/skills	DSH_HOME	<project>/.dsh/skills
Shared Agent	~/.agents/skills	DSH_AGENTS_HOME	<project>/.agents/skills
CC Switch	~/.cc-switch/skills	—	—
Codex	~/.codex/skills	DSH_CODEX_HOME	<project>/.codex/skills
Claude Code	~/.claude/skills	DSH_CLAUDE_HOME	<project>/.claude/skills
Gemini	~/.gemini/skills	DSH_GEMINI_HOME	<project>/.gemini/skills
OpenCode	~/.config/opencode/skills	DSH_OPENCODE_HOME	<project>/.opencode/skills
Cursor	~/.cursor/skills	DSH_CURSOR_HOME	<project>/.cursor/skills
Copilot	~/.copilot/skills	DSH_COPILOT_HOME	<project>/.github/skills
Windsurf	~/.codeium/windsurf/skills ~/.windsurf/skills	DSH_WINDSURF_HOME DSH_WINDSURF_USER_HOME	<project>/.windsurf/skills
Trae	~/.trae/skills	DSH_TRAE_HOME	<project>/.trae/skills
Trae CN	~/.trae-cn/skills	DSH_TRAE_CN_HOME	<project>/.trae-cn/skills
OpenClaw / Clawdbot	~/.openclaw/skills ~/.clawdbot/skills	DSH_OPENCLAW_HOME DSH_CLAWDBOT_HOME	—
Roo	~/.roo/skills	DSH_ROO_HOME	<project>/.roo/skills
CodeBuddy	~/.codebuddy/skills	DSH_CODEBUDDY_HOME	<project>/.codebuddy/skills
WorkBuddy	~/.workbuddy/skills	DSH_WORKBUDDY_HOME	<project>/.workbuddy/skills
Qoder	~/.qoder/skills	DSH_QODER_HOME	<project>/.qoder/skills
Qoder CN CLI	~/.qoder-cn/skills	DSH_QODER_CN_HOME	—
Qoder CN	~/.lingma/skills	DSH_LINGMA_HOME	<project>/.lingma/skills
Google Antigravity	~/.gemini/config/skills	DSH_ANTIGRAVITY_HOME	<project>/.agents/skills

Ordinary project-root <project>/skills directories are not scanned, so repository release resources are not exposed as Agent skills. OpenClaw / Clawdbot support is limited to the user-level sources above. Qoder CN CLI project skills use <project>/.qoder/skills and appear as Qoder. Qoder CN IDE uses the Lingma directories. Missing external source directories are not shown.

For a desktop workbench, download DSH Codex Desktop. Existing DeepSeek Harness installations can add plugins as needed by following each project's README. Below are 11 first-party plugins; consult the corresponding desktop release notes and bundled catalog for what that version includes.

Open an issue for bugs or suggestions. Include your DSH and plugin versions, reproduction steps, and a full screenshot for UI issues.

Source code lives in src and uses strict TypeScript while retaining the existing plugin architecture. Run npm run typecheck for type checks, npm run build to generate runtime files, and npm run verify for the full regression and package checks. GitHub and npm both include a ready-to-run lib. After changing source, run the build before committing. Packing still checks types and builds the JavaScript files required by the npm package. CI runs full verification on Node.js 22.19.0 and 24, and code changes also trigger the supported-host compatibility matrix. Contributions are welcome.

To test a source checkout, install dependencies using the pinned pnpm version, run npm run verify, then run npm pack. Install the resulting .tgz with dsh plugin --profile web add <package.tgz>, restart DSH and refresh the page. Do not use --ignore-scripts when packing: it skips the build hook.

Apache License 2.0