Plugin directory / Security / dsh-skill-authoring
dsh-skill-authoring
Verified · install-tested on dsh boomzikazita
What it does
DSH skill authoring toolkit: scaffold + 9-gate quality audit for skills
Works — verified, early-stage project
DSH skill authoring toolkit: scaffold + 9-gate quality audit for skills It installs cleanly and boots without issues in our testing. It's early-stage but functional.
“Verified” means our automated CI actually ran dsh plugin add in a clean profile and it booted — nothing more. Feature descriptions and version compatibility are the author’s claims. This is not a security audit and not an endorsement of third-party code.
README
dsh-skill-authoring
A DeepSeek Harness plugin for creating and maintaining high-quality agent skills. It scaffolds new skills from a compliant skeleton, audits existing SKILL.md files against a 9-point quality gate, and validates skill names against the DSH naming convention — so every skill in your library ships with structure, boundaries, examples, and verification paths.
The 9-gate standard is derived from vibe-coding-cn (adapted for DSH).
Features
| Tool | Description |
|---|---|
skill_scaffold |
Generate a compliant SKILL.md skeleton (frontmatter / whenToUse / Boundaries / QuickRef / Examples placeholders) plus references/index.md for a new skill. |
skill_audit |
Audit an existing SKILL.md against the 9 quality gates, printing a ✓/✗ table per gate. |
skill_check_name |
Validate a skill name against the DSH regex ^[a-z0-9]+(-[a-z0-9]+)*$ (lowercase + hyphens). |
The plugin also installs a skill-write-guard hook: when write/edit targets a SKILL.md under ~/.dsh/skills/, it runs the audit automatically and warns the agent if the file does not pass the 9 gates yet.
The 9 quality gates
- name — matches
^[a-z0-9]+(?:-[a-z0-9]+)*$, ≤ 64 chars - description — "what + when", 20–1024 chars
- whenToUse — ≥ 3 decidable trigger conditions
- boundaries — ≥ 3 "Not For / Boundaries" statements
- quickref — 1–20 directly reusable patterns (Quick Reference)
- examples — ≥ 3 end-to-end examples with Input / Steps / Acceptance
- references —
references/index.mdexists (long content split out) - verification — uncertain claims marked with source/evidence level
- style — operational-manual style (short imperative sentences, not a doc dump)
Installation
dsh plugin --profile web add github:boomzikazita/dsh-skill-authoring
Or clone/pin a specific release:
dsh plugin --profile web add github:boomzikazita/dsh-skill-authoring@v0.1.0
After installing, restart your dsh web instance (or the profile you installed into) so the tools register.
Configuration
The plugin ships with no required configuration (config: {} in cordis.patch.yml). Optional dsh config keys passed to the bundle are accepted and currently unused.
- Skills directory — defaults to
~/.dsh/skills(derived from the OS home directory at runtime; no hardcoded paths). - Python — the gate engine (
scripts/skill_gate.py) is invoked viapython3; a Python 3.8+ interpreter must be onPATH. - Scaffold target —
skill_scaffoldaccepts an optionaldirargument to generate the skeleton outside the default skills directory.
Development
node --check index.js # syntax check the plugin
python3 -m py_compile scripts/skill_gate.py # syntax check the gate engine
License
MIT © 2026 boomzikazita — see LICENSE.
Install
Install the catalog once, then DeepSeek Harness can find and install any plugin from this site automatically:
dsh plugin add dshbase-catalogThen say "install dsh-skill-authoring for me" — your agent finds it in the directory and installs it. Docs: dshbase-catalog · verified packs.
This plugin is GitHub source (not published to npm) — install it straight from the repo:
Web profile:
dsh plugin --profile web add github:boomzikazita/dsh-skill-authoringHeadless (CLI) profile:
dsh plugin --profile headless add github:boomzikazita/dsh-skill-authoringTest report
Verified: L1 install + L2 load + L3 runtime from GitHub source on dsh 0.1.0-rc.6.
Share this badge
Drop this badge into your README — it links back here and updates automatically when our test status changes:
[](https://dshbase.com/plugins/dsh-skill-authoring/)<a href="https://dshbase.com/plugins/dsh-skill-authoring/"><img src="https://dshbase.com/badges/dsh-skill-authoring.svg" alt="dshbase install-tested"></a>