arch3rPro/dsh-skills
Generalized development-specification skills distilled from DeepSeek Harness's engineering conventions — defensive patterns, code conventions, testing tiers, prose standards, decision records, review and PR discipline.
项目介绍Project Overview
dsh-skills 是从 DeepSeek Harness 工程规范提炼的 10 项可执行编码代理技能,覆盖架构、测试、文档与流程四类,全部为模型自动调用。每项技能以 SKILL.md 形式独立交付,可通过 npx skills 单独安装或作为 Claude Code 插件整体使用,适用于需要将团队编码规范注入代理工作流的场景。注意技能依赖描述清晰,README 文档与 SKILL.md 内容需保持同步。
dsh-skills is a bundle of ten model-invoked coding-agent skills distilled from DeepSeek Harness engineering conventions, spanning architecture, testing, documentation, and process. Each skill ships as a standalone SKILL.md and installs via npx skills or as a Claude Code plugin, letting agents auto-apply standards during coding, review, or documentation tasks. The README is a single config source, so any convention change must keep SKILL.md and docs aligned.
请帮我了解并安装插件:【dsh-skills】【https://github.com/arch3rPro/dsh-skills】
把上面这条消息直接发给当前会话里的 DSH,让它帮你了解并安装。安装命令不一定准确,发给 DSH 更稳。Send this message to DSH in your current session. CLI install commands may not be accurate across systems — DSH will figure it out for you.
或使用命令行安装(适合开发者)Or use CLI install (for developers)
命令行安装CLI Install
dsh plugin --profile web add github:arch3rPro/dsh-skills
把 arch3rPro/dsh-skills 加入你的 DSH 配置(web profile)即可启用。
READMEREADME
DeepSeek-Harness-Skills
A set of coding-agent skills distilled from the engineering conventions of DeepSeek Harness — executable standards your coding agent applies while coding, reviewing, testing, or documenting.
English · 简体中文
Get started
Install the set with the skills.sh installer, then pick the skills and agents you want:
npx skills@latest add arch3rPro/dsh-skills
Or just read one — each SKILL.md is a self-contained executable standard. Pick the discipline that matches what you're doing: code-conventions, testing-tiers, prose-standard, or any in the set.
The set
Ten skills across four categories. Every one is model-invoked — the agent reaches for it automatically when a trigger fires.
| Skill | Category | What it does |
|---|---|---|
| defensive-patterns | architecture | bug-class rules for lifecycle, concurrency, teardown, untrusted I/O |
| code-conventions | architecture | reversible side effects, explicit-over-implicit, config-over-hardcoding, branded ids |
| extension-points-and-seams | architecture | build a seam only when a capability has multiple implementations or consumers |
| testing-tiers | testing | pick the right tier, test the real entry path, verify the world not the self-report |
| prose-standard | documentation | contract-first prose: preserve propositions, drop reasoning transcripts |
| documentation-placement | documentation | one home per fact; tutorials vs references; budgets as guardrails |
| decision-records | process | ADRs with classification, lifecycle, mandatory alternatives |
| minimal-evidence-checks | process | the smallest check set that covers the diff; fix or explain failures |
| code-review | process | two axes (standards + spec); substantiated blockers over nits |
| pr-history-hygiene | process | lease-protected rewrites, deliberate labels, native stack merges |
Beta (in development)
Five further disciplines are grounded in DeepSeek Harness and under development. They are npx skills-installable but not yet part of the official plugin bundle.
| Skill | Category | What it does |
|---|---|---|
| postmortem | process | backward-looking failure record: executive summary, root cause, guardrails |
| runtime-invariants | testing | assert only authoritative state, never service/method presence; fail loud |
| responding-to-review-on-a-stack | process | fix on the introducing PR, propagate up-stack, re-audit after rewrites |
| event-contract-matrix | documentation | who produces and who listens to each event, bypass sites included |
| module-layering | architecture | derive and enforce the module dependency graph |
Where they come from
Every skill is distilled from a real convention in DeepSeek Harness and adapted so it works in any codebase — not only inside the harness it came from.
How it's packaged
Each skill is one <category>/<name> directory carrying three files in a single change:
SKILL.md— the executable standard (Claude Code / any agent harness)agents/openai.yaml— Codex metadata and invocation policydocs/<category>/<name>.md— a human-facing docs page
skills/
architecture/ how code is shaped and how failure is handled
testing/ how behavior is verified
documentation/ how prose and docs are written
process/ the workflow around code — decisions, review, checks, git
Invocation design
Skills are either model-invoked (the agent reaches for them automatically when a trigger fires) or user-invoked (only a human typing the skill's name can fire them — zero context load, but the human is the index). All ten skills here are model-invoked.
Installation
The two routes below are alternatives, not add-ons — pick one.
npx skills — any agent (Claude Code, Codex, …)
Install one skill at a time (or the whole set from Get started):
npx skills@latest add arch3rPro/dsh-skills --skill=code-review
npx skillspulls from GitHub — publish the repo first, then run the command above.
Claude Code — the plugin
Add this repo as a Claude Code marketplace, then install the plugin:
claude plugins marketplace add arch3rPro/dsh-skills
claude plugins install dsh-skills@dsh-skills
The plugin manifest lives in .claude-plugin/ (marketplace.json + plugin.json).
Acknowledgments
- DeepSeek Harness — an open-source agent harness developed by DeepSeek AI.
- mattpocock/skills — Matt Pocock's agent skills for real engineering.
ruvnet/ruflo
amruthpillai/reactive-resume
volcengine/OpenViking
Molunerfinn/PicGo
titanwings/colleague-skill
nocobase/nocobase
Tencent/WeKnora