Introduction

When using local skills in DSH (DeepSeek Harness), it is often necessary to confirm the file name, description, and use cases before deciding how to hand the skill to the model. asakumizy/dsh-local-skills is a DeepSeek Harness (DSH) plugin that provides a local SKILL browser page for the Web UI, organizing skill files from the local directory into the Settings page and providing invocation methods.

What is it

It is maintained by asakumizy and is licensed under MIT. The positioning of this plugin is to browse local SKILLs in the DSH Web UI, view names, descriptions, and use cases, and obtain invocation prompts via the “Use” button.

Core Features

Local SKILL Browser

The plugin scans the local directory and identifies two skill file formats:

  • Directory format: <name>/SKILL.md
  • Flat format: <name>.md

These files require YAML frontmatter, and the name must be in kebab-case, for example, code-review.

Real-time Refresh

After adding, modifying, or deleting a skill, the model directory and the web UI will refresh in real-time. This behavior is controlled by the watch configuration, defaulting to true.

Web View

The plugin provides a Skills page in Settings, listing the names, descriptions, and use cases of available skills.

Use Button

Skill entries on the page provide a “Use” button. Clicking it explains how to call the skill: enter /name or directly mention the skill, and copy the example prompt with one click.

Installation and Enablement

The installation commands given in the README use the placeholder <path-to-this-package>, which needs to be replaced with this package’s path before execution.

  1. Install to the web profile:
dsh plugin --profile web add <path-to-this-package>
  1. Restart the Web:
dsh web

If installing to any arbitrary profile, you can use:

dsh plugin --profile <name> add <path>

The README mentions that pnpm is required for this method. You can also manually put the package into:

$DSH_HOME/profiles/node_modules

and add the package name to that profile’s dsh.profile.bundles.

Configuration

After installing to the web profile, you can configure local-skills in the web Plugins settings page or in cordis.patch.yml.

Common configuration items:

  • skillDirs: Extra directories to scan, using absolute paths or paths starting with ~; leave empty to default to scanning ~/.dsh/local-skills
  • watch: Whether to monitor file changes in real-time, default true

You can override this in ~/.dsh/profiles/web/cordis.patch.yml like this:

- id: local-skills
  config:
    skillDirs:
      - ~/my-skills
      - D:/work/skills

Platform Compatibility

The Host side depends on ctx.skills / dsh-skill, adapting to profiles such as web, desktop, tui, headless, etc.; if the profile lacks the skills service, the plugin will not activate and will not crash. The Client side declares dsh.client.platform as web, displaying the settings page only in the web browser; the pure terminal (TUI) has no browser UI, so the Client side is not loaded.

Use Cases and Notes

Suitable for users who maintain local SKILL files and want to view and copy invocation prompts in the DSH Web UI. The plugin runs with the permissions of the current dsh process; check the source code and license before installing.

Links