DSH Quality
Advanced
7 min read

Publish to GitHub topic dsh-plugin & Get Rated on the Hub

There is no official registry — the discovery mechanism is the dsh-plugin GitHub topic. Publish, add the topic, and let the Hub rate you.

Last updated: 2026-08-19

Why the topic is the registry

dsh has no official plugin marketplace. The community discovery mechanism is a convention: repositories tagged with the GitHub topic dsh-plugin. Directories like awesome-dsh-plugin and this Hub both crawl that topic — so a missing tag means your plugin is invisible.

Pre-publish checklist

  1. Tag the repo with the dsh-plugin topic on GitHub (Repository settings -> Topics).
  2. Declare `dsh.bundle` in package.json so installers can activate it as a profile layer.
  3. README: include the install command and the license. A one-liner install snippet is the difference between tried and skipped.
bash
dsh plugin --profile web add github:owner/repo

Lock versions for safety

Installing from a GitHub source runs the repository's build scripts at install time. Always pin what you install:

bash
# Pin a commit or a tag for reproducible, auditable installs
dsh plugin --profile web add github:owner/repo@commit
dsh plugin --profile web list
dsh plugin --profile web remove github:owner/repo

Get rated on the Hub

The DSH Plugin Quality Hub runs a daily automated evaluation pipeline (GitHub Actions): it discovers new dsh-plugin repositories, scores them across maintenance, docs, npm and ecosystem, and publishes Top Rated, Trending and Security Watch. Submit once, get re-scored automatically as your repository changes.

Submit your plugin at the Hub — a Top Rated badge is a stronger signal than a README claim.

The loop is closed

Publish -> add the topic -> get rated -> link your tutorial back to your own evaluation page. That is the same content loop this site is built on: tutorials reference examples, examples reference rated plugins, and every rated plugin links back to a tutorial.