deepseekplugins

DeepSeek Harness plugin

dsh-plugin-development

Portable Agent Skill for developing and auditing DeepSeek Harness plugins, with an optional DSH bundle adapter.

Skills
Jump to install

Source facts

Repository
w2112515/dsh-plugin-development
Latest update
Aug 17, 2026
Category
Skills
GitHub stars
14
Format
skill
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/w2112515/dsh-plugin-development
Plugin: dsh-plugin-development
Author: w2112515

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer3 files
README.mdSource · read only

DSH Plugin Development

![Release](https://github.com/w2112515/dsh-plugin-development/releases) ![Validate](https://github.com/w2112515/dsh-plugin-development/actions/workflows/validate.yml) ![License: MIT](LICENSE)

DSH Plugin Development is a portable Agent Skill for designing, implementing, packaging, reviewing, and diagnosing DeepSeek Harness plugins. The same canonical Skill directory works with Codex, Claude Code, and DSH. An optional DSH bundle adapter adds profile-scoped installation and reversible removal without creating another copy of the workflow.

> Beta and unofficial. This community project is not affiliated with or endorsed by DeepSeek. DeepSeek Harness is in developer preview, so current repository instructions, executable constraints, types, manifests, and Loader behavior remain authoritative.

Project shape

PartPurpose
[skills/dsh-plugin-development](skills/dsh-plugin-development)Canonical portable Skill and its on-demand references and script.
[skills/dsh-plugin-development/agents/openai.yaml](skills/dsh-plugin-development/agents/openai.yaml)Optional Codex UI metadata; it does not fork the Skill instructions.
[index.js](index.js) and [cordis.patch.yml](cordis.patch.yml)Thin optional adapter that registers the canonical Skill in a DSH profile.
.codex-plugin / .claude-pluginIntentionally absent. Neither host requires a plugin to use the Skill.

The Skill distinguishes live dynamic Cordis plugins, source-backed DSH workspace packages, and out-of-tree installable bundles before applying mode-specific rules. It adds no MCP server, account, credential, or remote-service dependency.

Codex

Install or link the canonical directory as either:

  • a personal Skill at ~/.codex/skills/dsh-plugin-development; or
  • a repository Skill at <repo>/.agents/skills/dsh-plugin-development.

You can also ask $skill-installer to install this GitHub directory:

https://github.com/w2112515/dsh-plugin-development/tree/main/skills/dsh-plugin-development

Invoke it explicitly with $dsh-plugin-development, or let its description trigger it for matching DSH plugin work. A Codex plugin is not required.

Claude Code

Install or link the same canonical directory as either:

  • a personal Skill at ~/.claude/skills/dsh-plugin-development; or
  • a repository Skill at <repo>/.claude/skills/dsh-plugin-development.

Invoke it with /dsh-plugin-development, or let Claude load it automatically for matching work. The directory uses the portable Agent Skills frontmatter subset and does not depend on Claude-only arguments, shell injection, subagent fields, or path variables. A Claude Code plugin is not required.

DeepSeek Harness

DSH can discover the same directory directly from:

  • <repo>/.dsh/skills/dsh-plugin-development;
  • <repo>/.agents/skills/dsh-plugin-development; or
  • <dshHome>/skills/dsh-plugin-development.

The repository .agents/skills location is shared by Codex and DSH, so those two hosts can consume one checked-in copy.

Optional DSH bundle adapter

Use the bundle only when you want dsh plugin to own profile-scoped installation, versioning, composition, and removal:

The command below installs the current v0.2.0-beta.1 adapter. The previous v0.1.0-beta.1 release remains immutable.

dsh plugin --profile web add https://github.com/w2112515/dsh-plugin-development/releases/download/v0.2.0-beta.1/dsh-plugin-development-0.2.0-beta.1.tgz
dsh --profile web --dump-config

The dumped configuration should contain the dsh-plugin-development layer and row ID dsh-plugin-development-skill. The adapter reads metadata and instructions from the packaged canonical Skill, registers it through ctx.skills, and disposes that registration when removed.

For local adapter development:

dsh plugin --profile web add .

Git installation also needs no prepare or pnpm allowBuilds because the package ships plain JavaScript and Markdown:

dsh plugin --profile web add github:w2112515/dsh-plugin-development#v0.2.0-beta.1

Use a reviewed commit SHA instead of a movable branch for higher-assurance Git installs.

Portable compatibility contract

The canonical directory follows the Agent Skills specification:

  • SKILL.md uses only the shared name and description frontmatter fields;
  • the directory name matches the Skill name;
  • references and scripts use paths relative to the Skill directory;
  • detailed mode guidance loads on demand; and
  • host-specific UI metadata does not alter the workflow.

Format compatibility does not make unavailable tools appear. Dynamic runtime work still requires live Cordis inspection, definition, and run tools. Without them, the Skill must stop at source-backed design or diagnosis and report that activation was not verified.

What the Skill covers

DSH plugin modeTypical requestCompletion evidence
Dynamic runtime Cordis pluginDefine process-local Host or Client behavior with live Cordis toolsLive provider and Slot inspection, define/run state, and final diagnostics
DSH workspace pluginAdd or modify packages shipped in the DSH repositoryCurrent repository authority, focused tests, real Loader composition, lifecycle proof, and snapshots when product-visible
Installable DSH bundleShip an external package with dsh.bundle and cordis.patch.ymlPacked files, isolated profile installation, --dump-config, packaged boot, and cleanup evidence

The workflow also covers Loader export failures, Service Definition/Provider/Consumer ownership, model-visible logging, Client Slots, CLI surfaces, configuration, lifecycle disposal, profile precedence, Git build risk, and audit-only authorization. Marketplace listing and solution packs (整合包) belong to dsh-marketplace-publish.

Precedence and lifecycle

Direct project Skills remain under the host's normal discovery and precedence rules. In DSH, project-local entries can override the optional runtime registration by name. Removing the bundle disposes only its registration; it does not delete separately installed personal or project Skill directories.

Validate

Run the self-contained checks and inspect the packed DSH adapter:

npm test
npm pack --dry-run

Codex maintainers can additionally run the built-in Skill validator against the canonical directory:

python path/to/skill-creator/scripts/quick_validate.py skills/dsh-plugin-development

The runtime consumer check accepts a built DeepSeek Harness checkout and exercises both direct filesystem discovery and the optional bundle registration:

node scripts/verify-dsh-runtime.mjs path/to/deepseek-harness

For release evidence, install the exact packed tarball into an isolated DSH home, inspect --dump-config, load the installed entry, and verify registration, disposal, and removal. Static checks never replace those consumer paths.

The packaged read-only helper provides two early checks for plugin authors:

node skills/dsh-plugin-development/scripts/check-artifact.mjs workspace-function path/to/index.ts
node skills/dsh-plugin-development/scripts/check-artifact.mjs bundle path/to/package

Discoverability

The repository uses the GitHub dsh-plugin and Agent Skill topics. It does not claim membership in a separate DSH registry that the project has not defined.

Community

  • LINUX DO — community discussion and open-source sharing.

FAQ

Does this Skill create marketplace solution packs?

No. Catalog listing and solution packs (整合包) belong to dsh-marketplace-publish. This Skill stops at plugin implementation and verification.

Is this a Skill or a DSH plugin?

The maintained product is one portable Agent Skill. The repository also ships an optional DSH bundle adapter for users who prefer profile-managed installation.

Are there separate Codex, Claude Code, and DSH versions?

No. All three consume the same skills/dsh-plugin-development source. Only discovery paths, optional UI metadata, and the DSH installation adapter differ.

Does installation execute package build scripts?

No. The DSH adapter has no prepare, install, or postinstall script. Always inspect third-party source and the exact artifact before installation.

How should a compatibility problem be reported?

Open an issue with the host and version, DSH version or commit, selected plugin mode, target entry path, exact request or command, observed result, and unavailable evidence. Do not include credentials or private runtime data.

License

[MIT](LICENSE)

Back to searchOpen GitHub repository

More related plugins

View category