dsh-cc-switch-skills
English | 中文
A DeepSeek Harness (DSH) plugin that loads every skill in C:\Users\<current user>\.cc-switch\skills when DSH starts, and watches that directory for adds, renames, and deletes (no restart needed).
~/.cc-switch/skills is where cc-switch keeps its skills, each a directory bundle with a SKILL.md. This plugin feeds those skills into DSH's ctx.skills registry so they appear in the session skill catalog and can be loaded through the skill tool.
Features
- Loaded at startup: the plugin row mounts with DSH, scans the directory once, and registers every skill.
- Two skill shapes: directory bundles
<name>/SKILL.md and flat <name>.md files (one level only).
- YAML frontmatter parsing (aligned with the official
@deepseek-ai/dsh-skill-filesystem):
name (kebab-case), description (required);- optional
whenToUse, metadata, disable-model-invocation, user-invocable;
disable-model-invocation: true hides the skill from the model catalog; user-invocable: false hides it from user-facing commands.
- Lazy body loading: the catalog carries metadata only; every
skill call re-reads the current file, so edits to SKILL.md take effect immediately.
- Resource base:
resourceBase points at the skill directory so the model can resolve scripts/, references/, assets/ and friends.
- Live refresh: the root is watched recursively; adds / renames / deletes / frontmatter edits land on the next catalog refresh. A missing root is probed until it appears.
- Rank 300, same tier as the official
custom skill root: project skills win name clashes, user-level skills lose.
Install
Option 1: one-line CLI install (recommended)
dsh plugin --profile web add github:artorias-zj/dsh-cc-switch-skills
(Use --profile desktop for the desktop profile; once published to npm this becomes dsh plugin --profile web add dsh-cc-switch-skills.)
Option 2: from DSH — clone the repository (git clone https://github.com/artorias-zj/dsh-cc-switch-skills.git, then run pnpm install inside it), then run plugin_manager install_bundle targeting the clone directory, or install the local path from the Web sidebar Plugins page.
Option 3: manually — add "dsh-cc-switch-skills": "link:<clone dir>" to dependencies and "dsh-cc-switch-skills" to dsh.profile.bundles in ~/.dsh/profiles/<profile>/package.json, then run pnpm install in the profile directory.
Note: local installs (options 2 / 3) reference the directory via link: — keep the clone (including node_modules) in place.
Once installed (live profiles apply immediately; otherwise restart DSH) the skills show up in the session catalog.
Configuration
Optional config fields on the inserted row in cordis.patch.yml:
| Field | Default | Meaning |
|---|
dir | <homedir>\.cc-switch\skills | Root to scan; ~/ prefix supported; also overridable via DSH_CC_SWITCH_SKILLS_DIR |
providerName | cc-switch | Provider name registered into ctx.skills (must not be the reserved runtime) |
rank | 300 | Precedence against other providers on name clashes; lower wins |
watch | true | Watch the directory and refresh automatically |
Differences from the official provider
To achieve "load every skill", incomplete frontmatter is tolerated more than the official provider:
- missing (or non-kebab-case)
name → falls back to the directory / file name with a warning;
- missing
description → falls back to the first non-empty body line (truncated to 160 chars) with a warning.
Still skipped with a warning: invalid YAML frontmatter, missing frontmatter, invalid invocation booleans (e.g. user-invocable: maybe), and names that stay invalid after the fallback. Warnings go to the DSH log (hub.log).
Plugin Info
| Field | Value |
|---|
| One-line value | Loads every skill under ~/.cc-switch\skills (with scripts/references resource bases) into DSH at startup, live-refreshed on change |
| Category | Skills & Agents |
| Install command | dsh plugin --profile web add github:artorias-zj/dsh-cc-switch-skills |
| Supported profiles | web / desktop |
| Compatibility | DeepSeek Harness 0.2.x (ctx.skills service); Node.js ^22.15 or >=24; Windows / macOS / Linux |
| Permissions & services | Reads the local ~/.cc-switch\skills directory only; no external services, no telemetry, never mutates skill files |
| License | MIT |
Uninstall
Remove it from the DSH plugins page, or run plugin_manager remove_bundle targeting dsh-cc-switch-skills.
License
MIT
