dsh-skill-authoring

As a DSH skill library grows, many agent skills end up shipped without a consistent skeleton: no clear trigger conditions, no boundary declarations, no quick-reference patterns, no end-to-end examples, and no verification trail. The result is unpredictable agent behavior and no shared quality bar across a team. dsh-skill-authoring exists to close that gap.

It is built around a nine-point quality gate covering naming convention, description precision, trigger conditions, boundaries, reusable quick references, worked examples, reference splitting, uncertainty annotation, and operational-manual writing style. Three tools sit behind the gate: skill_scaffold generates a compliant SKILL.md skeleton plus references/index.md in one step; skill_audit scores an existing file against all nine gates and prints a pass or fail table; skill_check_name validates the name against the DSH regex. A write-guard hook is also installed: any write or edit targeting a SKILL.md under your skills directory triggers an automatic audit and warns the agent of gates that have not yet been met, embedding quality control directly into the everyday editing workflow.

This plugin is aimed at developers and tech leads maintaining a DSH skill library, as well as agent engineers who need a repeatable standard for every new or existing skill, whether you are scaffolding your first one or running a compliance pass across dozens.