In the ecosystem of DeepSeek Harness (DSH) and Agent Plugins 1.0, maintaining two plugin packages simultaneously increases development overhead. The dsh-dual-plugin-guide plugin is designed to address this issue: it teaches agents how to write a single set of plugin code that is compatible with both DSH static plugin packages and Agent Plugins 1.0.

Plugin Overview

This is a meta-plugin maintained by Fectivnfy112357 and categorized as “Workflow.” It is installed in both DSH and Agent Plugins 1.0 formats, serving as a tutorial for developers learning how to build dual-format plugins.

Core Features

  1. Compatibility guidance: Guides developers in writing plugins that work with both DSH static plugin packages (installed via dsh plugin) and Agent Plugins 1.0 (loaded via plugin.json + skills/).
  2. Scaffolding generation: Provides a scaffold.mjs script that can generate valid skeleton code conforming to the dual-format specification.

Installation and Enablement

Install using the official DSH command:

dsh plugin --profile web add dsh-dual-plugin-guide

After installing and restarting the profile, this skill appears in the agent’s skill directory.

Typical Usage

After an agent installs this skill, it can use the skill’s content as a reference to build its own dual-format plugin. For projects that need a quick start, you can use the plugin’s built-in scaffold.mjs script to generate a skeleton:

npx skills add Fectivnfy112357/dsh-dual-plugin-guide
# 或使用插件内的脚本
node skills/dsh-dual-plugin-guide/scripts/scaffold.mjs

Working Principles and Structure

This plugin serves three loaders simultaneously by sharing the same skills/ directory tree:

  • DSH: Registers the skill to the runtime via dsh.bundle.patch in cordis.patch.yml.
  • Agent Plugins 1.0: Directly reads the plugin.json and skills/ directory.
  • Standard Skills: Discovers the skills/ directory via npx skills.

lib/index.js is a minimal Cordis plugin that injects skills and registers SKILL.md into ctx.skills, ensuring relative reference paths resolve correctly.

dsh-dual-plugin-guide/
├── package.json       # 包含 DSH bundle 配置与 peerDependencies
├── plugin.json        # Agent Plugins 1.0 清单
├── cordis.patch.yml   # DSH bundle 的 patch 文件
├── lib/index.js       # Cordis 入口，注册 SKILL.md
└── skills/dsh-dual-plugin-guide/
    ├── SKILL.md       # 指导内容（单一来源）
    ├── scripts/       # scaffold.mjs 骨架生成器
    └── references/    # 事实清单（事件、服务、工具等）

Applicable Scenarios and Precautions

  • Applicable scenarios: Developers who need to build plugins compatible with both DSH static plugin packages and Agent Plugins 1.0.
  • Permission note: The plugin runs with the permissions of the current DSH process. Before installing, review the source code and license (MIT).
  • Dependency note: Requires the @deepseek-ai/dsh dependency (optional).

Summary

With this plugin, developers can learn how to serve both the DSH and Agent Plugins 1.0 ecosystems from a single codebase, reducing maintenance costs.