green-dalii/dsh-plugin-dev-skill
A skill pack that enables any agent to develop DeepSeek Harness (DSH) plugins correctly, efficiently, and in accordance with the official conventions.
安装Install
dsh plugin --profile web add github:green-dalii/dsh-plugin-dev-skill把 green-dalii/dsh-plugin-dev-skill 加入你的 DSH 配置（web profile）即可启用。
READMEREADME
Deepseek Harness Plugin Dev Skill
English | 简体中文
A skill pack that enables any agent to develop DeepSeek Harness (DSH) plugins correctly, efficiently, and in accordance with the official conventions.
Core deliverable: SKILL.md — an operating manual an agent can load directly, covering the mental model, copy-pasteable code templates, a step-by-step development workflow, and a verification checklist. Deeper background lives in the condensed reference docs under References/.
Note: the skill itself (
SKILL.md) and the reference docs are currently authored in Chinese (matching the official DSH documentation). Code templates and API names are language-neutral.
Highlights
- 🧠 First-principles based: turns the "revertible effects + reactive coeffects" theory of Cordis (DSH's underlying framework) into actionable rules and templates
- 🧩 Covers every plugin type: Tools (
defineTool), LLM adapters, service providers/consumers, hooks, configuration, packaging & publishing - ✅ Templates verified against the real SDK: all sample code passes
tsc --stricttype checking and runs end-to-end against the real Cordis loader - 🔗 Traceable upstream updates: every reference doc ends with the official-doc URLs, so content can be revised when upstream changes
Structure
dsh-plugin-dev-skill/
├── SKILL.md # Main skill file: the operating manual (read this first)
├── README.md # This file (English)
├── README.zh-CN.md # 中文说明
├── CHANGELOG.md # Changelog
├── CONTRIBUTING.md # Contribution guide
├── SECURITY.md # Security policy
├── LICENSE # MIT
└── References/ # Condensed, human/agent-readable reference material
├── 00-INDEX.md # Index
├── 01-dsh-architecture.md # DSH architecture overview
├── 02-plugin-basics.md # Plugin basics: shapes/lifecycle/effect/HMR
├── 03-tools.md # Tool development reference (defineTool)
├── 04-config.md # Plugin configuration & Schemastery
├── 05-llm-adapter.md # LLM adapter guide
├── 06-framework-services-events.md # Services & dependencies, event system
├── 07-publish.md # Packaging/install/profile/config layers
├── 08-capability-layering.md# Three-role capability design & seam catalog
├── 09-cordis-primer.md # Cordis primer & ctx API cheat sheet
├── 10-spatiotemporal.md # Paper summary (spatiotemporal composability)
└── 11-cookbook.md # Extension patterns (hooks/UI/protocol bridges/feature→mechanism)
Usage
- For agents: load
SKILL.mdand follow its development workflow (recon → implement → verify → deliver); consult the corresponding file underReferences/when deeper background is needed. - For humans: read
SKILL.mdandReferences/to get a complete picture of DSH plugin development.
Install as a DSH skill (optional)
The DSH skill system accepts both directory bundles (<name>/SKILL.md) and flat Markdown files (<name>.md). Local discovery roots, in priority order:
| Root | Scope |
|---|---|
<projectRoot>/.dsh/skills |
Project (rank 100) |
<projectRoot>/.agents/skills |
Project (rank 200) |
$DSH_HOME/skills (i.e. ~/.dsh/skills) |
User (rank 400) |
Example — install as a user-level skill (the folder name must match the name in the SKILL.md frontmatter, dsh-plugin-dev-skill):
mkdir -p ~/.dsh/skills/dsh-plugin-dev-skill
cp SKILL.md ~/.dsh/skills/dsh-plugin-dev-skill/SKILL.md
cp -r References ~/.dsh/skills/dsh-plugin-dev-skill/References
The skill name must be kebab-case (^[a-z0-9]+(?:-[a-z0-9]+)*$).
Use with other agents (Claude Code, Codex, etc.)
This skill follows the open Agent Skills standard: a folder with SKILL.md plus YAML frontmatter (name, description, whenToUse) and a supporting References/ folder — the same shape used by Claude Code, Codex, and many other agent hosts. Install it anywhere you install agent skills.
Option A — let your agent install it (recommended)
The simplest way: just tell your agent the repo address and let it clone and install the skill itself. For example, paste this into a Claude Code session:
Install the skill from https://github.com/green-dalii/dsh-plugin-dev-skill into
~/.claude/skills/dsh-plugin-dev-skill/and loadSKILL.mdwhen I work on DeepSeek Harness plugin development.
Or into a Codex CLI session:
Install the skill from https://github.com/green-dalii/dsh-plugin-dev-skill into
~/.agents/skills/dsh-plugin-dev-skill/.
A generic version that works with any agent:
Please install the skill from https://github.com/green-dalii/dsh-plugin-dev-skill into your skills directory (folder
dsh-plugin-dev-skillcontainingSKILL.mdandReferences/), then use it whenever the task involves developing DeepSeek Harness (DSH) plugins.
Option B — manual install
| Agent / host | Location | Invocation |
|---|---|---|
| Claude Code (personal) | ~/.claude/skills/dsh-plugin-dev-skill/SKILL.md |
/dsh-plugin-dev-skill, or auto-loaded when the description matches |
| Claude Code (project) | <repo>/.claude/skills/dsh-plugin-dev-skill/SKILL.md |
same |
| Codex CLI (user) | ~/.agents/skills/dsh-plugin-dev-skill/SKILL.md |
browse /skills, mention $dsh-plugin-dev-skill |
| Codex CLI (repo) | <repo>/.agents/skills/dsh-plugin-dev-skill/SKILL.md |
same |
| DSH | ~/.dsh/skills/dsh-plugin-dev-skill/SKILL.md |
see the DSH section above |
| Any Agent Skills host | <skills-dir>/dsh-plugin-dev-skill/SKILL.md |
per host |
Install with git clone (or symlink — both Claude Code and Codex follow symlinks, so git pull keeps the skill up to date):
git clone https://github.com/green-dalii/dsh-plugin-dev-skill.git ~/.claude/skills/dsh-plugin-dev-skill
# or:
ln -s /path/to/dsh-plugin-dev-skill ~/.claude/skills/dsh-plugin-dev-skill
Notes:
- Keep the folder name
dsh-plugin-dev-skill— it must match the frontmattername(Claude Code uses it as the command name). - Extra frontmatter fields such as
whenToUseare ignored by hosts that don't support them. - The skill body is currently authored in Chinese (matching the official DSH docs); code templates are language-neutral.
- Bonus: DSH reads
.agents/skillsfor project-level skills too, so one copy in<repo>/.agents/skills/dsh-plugin-dev-skill/serves both Codex and DSH.
Sources
- Official docs (中文 / English): https://deepseek-harness.github.io/deepseek-harness/develop/basic/
- Source repository: https://github.com/deepseek-ai/deepseek-harness
- Paper: A Programming Paradigm for Spatiotemporal Composability (the academic foundation of Cordis): https://github.com/cordiverse/paper/blob/main/paper.pdf
All reference docs are condensed digests (not verbatim copies of the official docs), organized around the goal of "developing correct, efficient, convention-compliant plugins".
Contributing
Issues and pull requests are welcome! Please read CONTRIBUTING.md first. For security-related matters, see SECURITY.md.
License
MIT © 2026 green-dalii
相关推荐Related
- deepseek-ai/deepseek-harness DeepSeek Harness: Everything is a Plugin.
- deepseek-ai/deepseek-harness DeepSeek Harness (dsh) — 由 DeepSeek AI 开发的开源 agent harness（智能体框架）。一切皆插件：核心 + 插件 + 技能 = 可热插拔的 AI 编程工作台。DeepSeek Harness: …
-
ruvnet/ruflo
🌊 The original agent meta-harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build c…
-
amruthpillai/reactive-resume
A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source a…
-
volcengine/OpenViking
Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.
-
Molunerfinn/PicGo
:rocket: The Ultimate Image Uploader for Efficient Creators. Supports Obsidian, Typora, VS Code etc. and 60+ image hosti…
-
titanwings/colleague-skill
将冰冷的离别化为温暖的 Skill，欢迎加入数字生命1.0！Transforming cold farewells into warm skills? It's giving rebirth era. Welcome to Digital …
-
nocobase/nocobase
NocoBase is an open-source AI + no-code platform for building business systems fast. Instead of generating everything fr…