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 policy
• docs/<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 skills pulls 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.