Skip to main content

dsh-web-ui/packages/dsh-skill-explorer

5.1kStars311Forks49Issues5Watchers

DSH Web GUI Skill Center panel: browse skills by source tier, enable/disable model calls, create and soft delete (move to .trash).

Evidence5/5methodologySourceInstallMaintenanceDSH versionSecurity scan
Machine-auditedInstall commandRepo verifieddsh-plugin topicLicenseREADMEAI wiki

ⓘ This plugin is a sub-package of the zhu1090093659/dsh-web-ui monorepo — stars and activity count the whole repository.

Language
TypeScript
License
Apache-2.0
Branch
dev
deepseek-harnessdshdsh-pluginweb-ui

Install

cmdweb profile
$ dsh plugin --profile web add @linxin666/dsh-client-ui-skill-explorer

Run the command above in your terminal to install this plugin via the dsh CLI. You can switch Profile in the top-right corner. New to dsh? Read the beginner tutorial

Install via your agent

Install the DeepSeek Harness plugin zhu1090093659/dsh-web-ui/packages/dsh-skill-explorer for me: review the repository at https://github.com/zhu1090093659/dsh-web first, then run the install command and verify the plugin loads successfully.

Paste this instruction to the DSH Web GUI assistant — it will install and verify for you.

Brief Description

dsh-web-ui is a suite of DSH Web GUI plugins and skins. The sub-package included in this entry, dsh-skill-explorer, provides a "Skill Center" panel for Web GUI: browse all loaded skills by source hierarchy, enable/disable model invocation, create new skills, and convert deletions into recoverable trash operations.

Core Features

  • Browse skills grouped by source (system built-in, project .dsh/skills, project .agents/skills, custom directories, user ~/.dsh/skills, user ~/.agents/skills, runtime registered)
  • Enable or disable individual skills' model invocation in the panel by rewriting the disable-model-invocation field in SKILL.md frontmatter, which triggers the official directory hot refresh
  • Create new skills via form,可以选择写入用户级目录(本机所有项目共享)或项目级目录(仅当前项目)—can choose to write to user-level directory (shared across all local projects) or project-level directory (only current project)
  • When deleting a skill, move SKILL.md to a sibling .trash directory instead of permanent deletion, facilitating recovery after accidental operations
  • Provides /api/dsh-skill-explorer/health health check endpoint for host or automation to verify plugin status
  • Follows symbolic links during scanning, can identify skills mounted via links within the project repository (marked as "symlink")

Technical Implementation

  • Language: TypeScript
  • Key Dependencies: @deepseek-ai/cordis (cordis plugin framework), @deepseek-ai/dsh-host-webserver (host half-route mounting), @deepseek-ai/dsh-client-runtime + @deepseek-ai/dsh-client-locale (browser half injection), react@^18.2.0
  • Architecture: cordis plugin with host/client dual halves—host half mounts 5 /api/dsh-skill-explorer/* routes within dsh process and reads ctx.skills/ctx.sessions, client half injects sidebar entry into native DOM via MutationObserver and renders Skill Center panel with React overlay
  • Entry Files: src/index.ts (host), src/client/index.ts (browser)

Use Cases

DSH users who have accumulated a large number of skills scattered across multiple directories (system built-in, project root, user root, custom directories), making manual management difficult; this plugin allows centralized viewing in one panel, quick enable/disable of model invocation, and on-demand creation or cleanup of skills, avoiding errors when editing SKILL.md files.

Prerequisites & Compatibility

DependencyMin VersionDescription
DSH0.1.0-rc.8+Depends on @deepseek-ai/dsh-client-runtime / @deepseek-ai/dsh-host-webserver / @deepseek-ai/dsh-client-locale ^0.1.0-rc.8 (package.json:39-58)
Node.js^22.19 || >=24Global agreement in packages/AGENTS.md:9
PlatformCross-platformOnly uses node:fs / node:os / node:http standard libraries, no native dependencies
Native ModulesNoneBundled pure JS

Installation

dsh plugin --profile web add github:zhu1090093659/dsh-web-ui/packages/dsh-skill-explorer

Configuration Options

ConfigTypeDescriptionDefault
enabledBooleanMaster switch for plugin; when set to false, all routes will not be registeredtrue (effective when not disabled)
customSkillDirsString ArrayAdditional custom skill root directories; will be listed under "Custom Directory" group after scanning[]
dshHomeStringOverride for user-level DSH config root; used to locate ~/.dsh/skills$DSH_HOME env var, otherwise ~/.dsh
agentsHomeStringOverride for user-level agents config root; used to locate ~/.agents/skills$DSH_AGENTS_HOME env var, otherwise ~/.agents

FAQ

Q: The "Skill Center" entry doesn't appear in the sidebar after installation. What should I do?

A: Need to restart dsh web. Bundle injection is completed during DSH startup; runtime hot reload does not re-render the sidebar. After restart, the entry will appear between the "New Session" button and the workspace browser.

Q: Why don't system built-in or runtime-registered skills have enable/disable switches and delete buttons?

A: These two types of skills come from the ctx.skills registry and have no editable files. The plugin only trusts paths produced by file system scanning (src/routes.ts:165-169), so these controls are hidden on the panel. Write routes will also return 404 when receiving requests.

Q: The delete button is gone. Can this skill not be deleted?

A: Yes. Skills mounted via symbolic links cannot be deleted—deleting would move the link target's SKILL.md out of its original location, beyond the current skill root (src/collect.ts:144-154). The panel hides the delete button for these, and the delete route will reject requests with 400. Enable/disable still works for these skills.

Q: Can the Skill Center be used when accessing DSH from a phone or other LAN devices?

A: Not by default. All routes only accept loopback requests or browser same-origin markers; unpaired LAN clients will first receive 403 forbidden: loopback-only. If dsh-remote-web-ui is also installed and device pairing is completed, paired devices' cookies are an additional allowlist path (src/access.ts:28-34).

Q: Do newly created skills take effect immediately?

A: Yes. The official dsh-skill-filesystem provider hot-scans new files, model directory refreshes instantly, no DSH restart needed. Note that the new skill's content will be injected into the model context as instructions; avoid writing sensitive information (src/client/locales.ts:52).

Q: What's the difference between project-level skills and user-level skills?

A: Project-level skills (written to .dsh/skills/ under project root) are only visible to the current project, suitable for version control alongside code; user-level skills (written to ~/.dsh/skills/) are shared across all local projects, suitable for cross-project general instructions. The panel creation form allows choosing between these two locations.

Q: Is there a size limit for skill content when creating?

A: Yes. If the body content (excluding frontmatter) exceeds 64KB when the form is submitted, the server will reject it with content exceeds 64KB limit (src/routes.ts:217-220).

Learning Curve

Beginner — Ready to use after installation, no source code reading required; refer to README security model and limitations section when wanting to understand frontmatter rewriting or symbolic link boundary behaviors.

Known Issues & Limitations

  • Project-level skills follow the workspace displayed in the panel: the list route supports explicit ?cwd= override; project root is determined by the nearest .git ancestor of that directory; if the workspace is not in a git repository, project-level skills cannot be located
  • Frontmatter parsing is a lightweight zero-dependency implementation, supporting block scalars, booleans, nested input blocks; unsupported obscure YAML features are handled by the official dsh-skill-filesystem provider's parsing, the Skill Center display may differ from official parsing
  • Linked skills (symbolic links) cannot be deleted (see FAQ); enable/disable works normally for linked skills, will rewrite the target's own SKILL.md frontmatter
  • Single-file symbolic links (pointing to a single .md) are replaced with a regular file during atomic rewriting; the symbolic link itself is not preserved; the linked target file is unaffected (README.md:96-100)
  • Bundled and runtime source skills are listed in the panel but do not expose editing controls (no path), cannot be enabled/disabled or deleted

Read the usage guide →

Install steps, key points, FAQ and compatibility for this plugin — auto-derived from indexed fields.

Listing badge

Listed on deepseek-plugin.org
[![Listed on deepseek-plugin.org](https://img.shields.io/badge/listed_on-deepseek--plugin.org-007EC6)](https://deepseek-plugin.org/plugins/zhu1090093659/dsh-web-ui/packages/dsh-skill-explorer)

Paste this markdown into your GitHub README to link back to this listing. The badge only states the listing — not a security endorsement.

← Back to plugin directory