DSH Project Skill Paths
Project-scoped custom Skill roots for DeepSeek Harness. The plugin finds the nearest Git project for each session cwd, reads .dsh/skill-paths.yaml, and adds those directories to that project's Skill discovery.
中文说明
Features
- Configure any number of project-relative Skill roots.
- Add and remove paths from the DSH Desktop settings card.
- Use
. to target the current DSH workspace or select a project directory.
- Reload changes to
.dsh/skill-paths.yaml without restarting DSH.
- Reject absolute paths and
.. paths outside the project by default.
- Keep every project's configuration inside that project.
Install
Install the tagged GitHub release into the Desktop profile:
dsh plugin --profile desktop add github:NeoRrrr/dsh-project-skill-paths#v0.3.0
Alternatively, download the prebuilt dsh-project-skill-paths-0.3.0.tgz asset from the v0.3.0 release, then install it locally:
dsh plugin --profile desktop add .\dsh-project-skill-paths-0.3.0.tgz
Restart DSH Desktop after the initial installation. The plugin requires DSH >=0.1.1-rc.2 and Node.js ^22.19.0 || >=24.0.0.
Configure a project
Open Settings → Plugins → Plugin configuration → Project Skill Paths. Enter . for the current DSH workspace or select a project directory, then add or remove Skill roots and save.
The settings card writes this file at the detected Git project root:
# .dsh/skill-paths.yaml
version: 1
skillPaths:
- .codex/skills
- tools/AI/claude/skills
Each entry is resolved relative to the project root. A Skill root may contain either <skill-name>/SKILL.md or <skill-name>.md, following the built-in DSH filesystem provider's naming and frontmatter rules.
Safety and scope
The plugin reads Skill files only while DSH resolves Skills for a session. It writes only the selected project's .dsh/skill-paths.yaml when you save the settings card. It does not read credentials, make outbound network requests, or modify Codex configuration.
By default, absolute paths and paths that escape the project are rejected. To explicitly allow shared paths outside a project, override the plugin row in the profile's cordis.patch.yml:
- id: project-skill-paths
config:
allowExternalPaths: true
DSH patch configuration replaces the row's complete config value rather than deep-merging it.
Priority and reload behavior
Configured paths use rank 250. Built-in project roots remain ahead of them, while configured project paths take precedence over global and user-level roots with the same Skill name:
| Source | Rank |
|---|
<project>/.dsh/skills | 100 |
<project>/.agents/skills | 200 |
| This plugin's configured roots | 250 |
Global customSkillDirs | 300 |
| User-level roots | 400/500 |
The plugin watches the project YAML file for creation, changes, and deletion. Skill directory contents continue to use DSH's built-in filesystem watcher.
Development
npm install
npm run check
npm pack --dry-run
For local development, install a link into a separate DSH profile:
dsh plugin --profile desktop add "link:$PWD"
Uninstall
dsh plugin --profile desktop remove dsh-project-skill-paths
License
MIT
