Introduction

The built-in skill tool in DeepSeek Harness (DSH) relies on the model to discover and load skills on its own. This often causes useful skills to be missed and makes lifecycle management of local skill files difficult. dsh-skills-manager aims to solve these issues by using active matching and hook mechanisms, filling the gap left by existing tools.

What It Is

This is a DSH plugin maintained by Wisdoverse, responsible for skill management in DeepSeek Harness. It provides active skill activation, trigger hook orchestration, GitHub source synchronization, and a built-in settings management interface.

Core Features

  • Active Activation: Automatically loads strongly matched skills and suggests weakly matched skills.
  • Skill-Level Hooks: Supports UserPromptSubmit, PreToolUse, PostToolUse, PostToolUseFailure, and SessionStart events.
  • GitHub Lifecycle Management: Supports installing, updating, synchronizing, and uninstalling skills.
  • Workspace-Aware Scoping: Project-level skills override user-level skills, and configurations do not leak across different workspaces.
  • Built-in Management: Provides a settings management UI and a skill_manager model tool.
  • Security Guardrails: Includes source allowlists, hook path validation, and runs hooks in a sandboxed environment with Shell execution disabled.

Installation and Enabling

Before installing, ensure the environment meets the following dependencies:
* DeepSeek Harness version: 0.1.1-rc.2, 0.1.2-alpha.3, 0.1.3-alpha.1, or 0.2.0-rc.2
* Node.js version: ^22.19.0 or >=24.0.0
* pnpm is available in the PATH

Use the following command to install the plugin:

dsh plugin --profile web add @wisdoverse/dsh-skills-manager

After installing, updating, or removing the plugin, you must restart the Web profile for the configuration to take effect.

Typical Usage

Skill Configuration Example

Declare activation modes and hooks in the frontmatter of SKILL.md:

---
name: repo-hardening
description: Review and harden a repository with build/test gates.
metadata:
  activation: auto             # auto | suggest | off
  triggers:
    - "harden"
    - "build fails"
  hooks:
    UserPromptSubmit:
      inject: "Run build and tests before reaching a conclusion."
    PreToolUse:
      - tool: bash
        when: "git push"
        decision: deny
        reason: "Direct pushes are not allowed"
    SessionStart:
      activate: true
---

Common Management Commands

# 更新插件
dsh plugin --profile web update @wisdoverse/dsh-skills-manager

# 移除插件
dsh plugin --profile web remove @wisdoverse/dsh-skills-manager

Use Cases and Notes

This plugin is suitable for scenarios that require fine-grained control over when skills are loaded, cross-project skill management, and managing the skill lifecycle through GitHub.

  • Runtime Environment: The plugin runs with the permissions of the current DSH process. Hook logic runs in a sandboxed environment, and Shell execution is disabled.
  • Security Check: Before installation, it is recommended to review the source code and license (MIT).

Conclusion

dsh-skills-manager enhances DSH’s ability to handle complex workflows through active activation and hook mechanisms. For more details, refer to the plugin directory or GitHub source code.