dsh-skill-fuzzy
Codex-style fuzzy skill search for the DeepSeek Harness Web GUI. The built-in
/ skill menu only matches skill-name prefixes (startsWith); this
plugin makes it search the way Codex does:
| Query |
Result |
/diag |
diagnosing-bugs (name prefix) |
/bug |
diagnosing-bugs (name substring) |
/bu |
diagnosing-bugs (name contiguous substring) |
/regression |
diagnosing-bugs (description term) |
Matching & ranking
- Names — port of Codex's
fuzzy-match: greedy, case-insensitive
ordered-subsequence matching with a window + start-of-string-bonus
score (smaller is better; prefix hits dominate).
- Descriptions — matched as contiguous, case-insensitive substrings
only (deliberately tightened after field testing: scattered subsequences
across a long description surfaced noise, e.g.
/m01 hitting a skill whose
description merely contains an m…0…1 spread).
- Ordering — name-hits first → score ascending → stable roster order.
Empty query returns the full roster unchanged (prefix behavior never
regresses).
Install
dsh plugin --profile web add /path/to/dsh-skill-fuzzy
# or from GitHub:
dsh plugin --profile web add github:ch1bug/dsh-skill-fuzzy
Restart dsh web and hard-refresh the GUI (the boot manifest is injected at
page load), then type / and search.
How it works
A web-client-only plugin. It wraps the built-in / skill source's
candidates() — found via inputTriggers.live.sources (the service's public
face is {ctx, name, live} + prototype {registerSource, sessionOf, sessions}; there is no all()/sources() accessor on the service — those
live on the menu controller's internal roster). The wrapper calls the
original candidates with an empty query to obtain the full roster
(preserving the skill.list RPC, user-only markers and abort semantics),
then filters/ranks it. registerSource is patched as a guard for late
re-registrations.
Development
lib/fuzzy.js Codex fuzzy-match port (fuzzyMatch)
lib/skill-rank.mjs ranking (rankSkills)
lib/client.js self-contained browser half (inlines both; pinned by
tests/sync.test.mjs against the tested modules)
tests/ node:test suite — node --test tests/fuzzy.test.mjs
tests/skill-rank.test.mjs tests/sync.test.mjs
The client bundle route serves a single client.js per plugin, so the pure
logic is inlined there and kept in sync with the tested modules by
tests/sync.test.mjs.
License
MIT. The fuzzyMatch algorithm is a port of
codex-rs/utils/fuzzy-match
from openai/codex — see NOTICE.md.