Back to search
dsh-find-plugin
SkillGitHub
Find DSH plugins inside the agent — live GitHub dsh-plugin topic search, star-ranked / 会话内搜索发现 DSH 插件
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Checked today
Badge for your README
Markdown
[](/listings/awesome-dsh-plugin--dsh-find-plugin)HTML
<a href="/listings/awesome-dsh-plugin--dsh-find-plugin"><img src="/api/listings/awesome-dsh-plugin--dsh-find-plugin/badge.svg" alt="findsafeskills safety rating" /></a>Install
i
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
# from npm (prebuilt, recommended) dsh plugin --profile web add dsh-find-plugin # or from GitHub dsh plugin --profile web add github:awesome-dsh-plugin/dsh-find-plugin
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 92 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # dsh-find-plugin [](https://awesome-dsh-plugin.com)
- English | [中文](README.zh.md)
- **A plugin that finds plugins** — think [`/find-skills`](https://skills.sh) from skills.sh, for DSH.
- Tell your agent what you want ("notify me on WeChat when a task finishes"),
- and it searches the DSH plugin ecosystem on GitHub for you — top results by
- stars, each with a one-line description and an install command.
- <img src="https://raw.githubusercontent.com/awesome-dsh-plugin/dsh-find-plugin/main/assets/demo-en.png" alt="find_dsh_plugin in action" width="640">
- ## Install
- ```sh
- # from npm (prebuilt, recommended)
- dsh plugin --profile web add dsh-find-plugin
- # or from GitHub
- dsh plugin --profile web add github:awesome-dsh-plugin/dsh-find-plugin
- ```
- ## Usage
- Restart `dsh web` after installing, then just talk to the agent — it calls
- `find_dsh_plugin` on its own whenever plugin discovery helps:
- - "What terminal TUI plugins are there?"
- - "I want to get a WeChat notification when a task finishes — any plugin for that?"
- - "Find me something for reviewing git diffs inside DSH."
- Each result comes back with stars, a description, the repo link, and a
- ready-to-run `dsh plugin add` command — ask the agent to install one and
- it can run the command for you.
- ## How it works
- - Live GitHub repository search scoped to the official `dsh-plugin` topic,
- re-ranked by stars (5-minute per-query cache).
- - When a result is also listed on
- [awesome-dsh-plugin](https://awesome-dsh-plugin.com), its hand-written
- bilingual description from `plugins.json` replaces the GitHub one (the
- `lang` parameter picks the language) — ranking is untouched.
- - Every result comes with a ready-to-run `dsh plugin add` command. Plugins
- are third-party code — review the source and pin a commit.
- ### Rate limits and offline fallback
- GitHub's **search** API allows only 10 requests/minute per public IP when
- unauthenticated, and that quota is shared by every host behind the same egress
- IP (carrier CGNAT, corporate NAT, …), so a search can fail with `HTTP 403` for
- reasons outside your control. The plugin therefore:
- - uses the **`GITHUB_TOKEN` DSH credential** when one is configured (30
- req/min, account-scoped, immune to shared-IP exhaustion). Optional — without
- it the tool still works, just closer to the anonymous limit;
- - retries a rate-limited (403/429) or failed request once, then degrades
- instead of failing: it falls back to **keyword matches from the curated
- list** and says so in the result note;
- - caches the curated list on disk (`$DSH_HOME/cache/dsh-find-plugin/`) and
- revalidates it with `If-None-Match` / `If-Modified-Since`, so restarts and
- offline runs use the full ~3400-entry list instead of the small bundled
- snapshot.
- - says *why* a request failed. Node reports every transport failure as a bare
- `fetch failed` and hides the useful part in `cause`, so the plugin surfaces
- the chain (`fetch failed ← certificate has expired (CERT_HAS_EXPIRED)`) and
- names the one trap that otherwise looks like a plugin bug: a system proxy or
- VPN accelerator, which Node's `fetch` ignores unless DSH itself was started
- with `NODE_USE_ENV_PROXY=1` (or `--use-env-proxy`). A browser has no such
- rule — which is why GitHub opens fine and this still fails.
- ## Compatibility
- DSH plugin APIs are prerelease-versioned, and node-semver only lets a
- prerelease satisfy a range that carries a prerelease on the *same*
- major.minor.patch — so a peer range pinned to one host line silently stops
- matching the next one. The declared `@deepseek-ai/dsh-tools` range therefore
- names every shipped line through `0.1.7`, and `npm run check:peers` (run in CI)
- resolves the current `latest`/`next` host lines from the registry and fails the
- day a new one is not covered.
- ## Development
- ```sh
- npm run typecheck # tsc --noEmit
- npm test # offline tests (mocked fetch)
- FINDP_LIVE=1 npm run test:live # opt-in real-network cases
- ```
- ## License
- MIT © awesome-dsh-plugin
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.