boomzikazita/dsh-skill-authoring

DSH skill authoring toolkit: scaffold + 9-gate quality audit for skills

dsh-skill-authoring is a plugin for creating and maintaining high-quality agent skills: skill_scaffold generates a compliant SKILL.md skeleton (frontmatter / whenToUse / Boundaries / QuickRef / Examples placeholders) plus references/index.md; skill_audit checks an existing SKILL.md against nine quality gates and prints a ✓/✗ table per gate; skill_check_name validates names against the DSH regex ^[a-z0-9]+(-[a-z0-9]+)*$. A skill-write-guard hook runs the audit automatically whenever write/edit targets a SKILL.md under ~/.dsh/skills/ and warns the agent when a file does not yet pass.

Agent Capabilities ★ 0 updated 2026-08-18 ✅ runtime-tested
View on GitHub ↗

Install

dsh plugin --profile web add github:boomzikazita/dsh-skill-authoring

GitHub install per README (EN primary): dsh plugin --profile web add github:boomzikazita/dsh-skill-authoring (or pin @v0.1.0). npm dsh-skill-authoring 404 verified 2026-09-03 — GitHub route only.

Compatibility

DSH profiles with the skills seam; write/edit hooks on ~/.dsh/skills/; SKILL.md convention per the 9-gate standard (derived from vibe-coding-cn, adapted for DSH).

Details

Recent updates

No changelog section in README; v0.1.0 tag referenced by the pinned install form.

FAQ

What are the nine gates?
name (regex + ≤64 chars), description (what + when, 20–1024 chars), whenToUse (≥3 triggers), boundaries (≥3 statements), quickref (1–20 patterns), examples (≥3 end-to-end), references/index.md, verification and structure conventions.
When is the audit automatic?
A skill-write-guard hook runs whenever write/edit targets a SKILL.md under ~/.dsh/skills/, warning the agent if the file does not yet pass all nine gates.
What does scaffold produce?
A compliant SKILL.md skeleton with frontmatter, whenToUse, Boundaries, QuickRef and Examples placeholders, plus a references/index.md.

Alternatives

hexbee/dsh-skill-panel · saitamahang/dsh-skill-importer

More plugins in Agent Capabilities

Browse more in Agent Capabilities

Guides for Agent Capabilities plugins