Foreword

If you already have multiple Agent Skills locally, they may be scattered across different directories, such as ~/.agents/skills, ~/.claude/skills, ~/.codex/skills, ~/.config/opencode/skills, and ~/.gemini/skills. Opening each directory individually to view and toggle skills can be quite cumbersome.

The purpose of dsh-agent-skills is to allow you to view, start, stop, and manage local Agent Skills within the DeepSeek Harness settings page.

What Is This

dsh-agent-skills is a DSH plugin maintained by minivv, licensed under MIT.

Its one-line positioning is: View, start, stop, and manage local Agent Skills within the DeepSeek Harness settings page.

It does not modify the original SKILL.md.

Core Features

Here are the listed capabilities:

  • Automatically scans ~/.agents/skills, ~/.claude/skills, ~/.codex/skills, ~/.config/opencode/skills, and ~/.gemini/skills
  • Supports custom skill directories
  • Toggles skills by directory or individually
  • Searches, views descriptions, and monitors skill file changes
  • Does not modify the original SKILL.md

Installation and Activation

First, install the plugin:

dsh plugin --profile web add dsh-agent-skills

After installation, open “Settings → Agent Skills”, click “Enable Takeover of DSH Skills”, and then click “Restart DSH”.

Typical Usage

Below are the usage steps provided in the plugin description:

  1. In “Settings → Agent Skills”, check the auto-discovered directories, or click “+ Add Directory”.

  2. Use directory and skill toggles to control available skills.

  3. After a skill change notification appears, click “Refresh Page”.

  4. After modifying skill files, click “Rescan” or wait for automatic refresh.

If you need to restore DSH’s original skill sources, you can click “Cancel Takeover” and restart DSH.

Plugin settings are saved in:

$DSH_HOME/agent-skills/state.json

Skill Format Requirements

When using local skills, please note the following limitations:

  • Skill names must match [a-z0-9]+(?:-[a-z0-9]+)*
  • SKILL.md requires YAML frontmatter
  • name should be in lowercase kebab-case

Applicable Scenarios and Notes

This is suitable for scenarios where you already maintain multiple Agent Skills locally and wish to view, start, stop, and manage them uniformly within the DSH settings page.

Before use, please note:

  • After a DSH upgrade, if the toggle fails, re-enable takeover and restart DSH
  • Git installation may require authorizing pnpm to execute build scripts
  • Development requires Node.js 20+
  • Before uninstalling, first click “Cancel Takeover” and “Restart DSH” in the settings page
  • The plugin runs with the current DSH process permissions; before installation, check the source code and license

Links

GitHub:

https://github.com/minivv/dsh-agent-skills