PerryLink/dsh-plugin-guide

Install

dsh plugin --profile web add dsh-plugin-guide

What it does

A "plugin development knowledge base" installed as an agent skill. Its goal is straightforward: stop your agent from making up DSH plugin APIs.

Features

• Includes official documentation, a version compatibility matrix, migration points, and known pitfalls
• Ships with two CLIs: scaffolder (generates skeletons) and checker (validates)
• Loads on demand rather than as a persistent prompt, so it does not occupy everyday context
• After installation, ask the agent directly: "Use the dsh-plugin-guide skill to help me write a plugin"

Good fit for

• Want to write DSH plugins yourself
• Assess whether a given plugin implementation is reliable
• Migrate old plugins after upgrading DSH

Advice

• Before writing a plugin, have it read the compatibility matrix for the corresponding version
• Start from the skeleton it generates; you will hit fewer pitfalls than writing from scratch
• It can be used with the mirror on gitee for faster access from mainland China

Cautions

• The knowledge base may lag; DSH iterates quickly, so official documentation is ultimately authoritative
• It teaches "how to write a plugin" and does not guarantee that the plugin you write will work well
• It is itself a skill and only takes effect when invoked; it will not proactively stop you from making mistakes