dsh-skills-mcp

本地开发必须用 link:（profile 使用 hoisted linker，file: 是安装时快照）

dsh plugin --profile web add link:/path/to/dsh-skills-mcp

### 方式二：GitHub

仓库已提交构建产物（`dist/`），因此 Git 源安装**不需要**在本地跑构建脚本，不会触发 `git-hosted plugins build on install` 的拦截。

```bash
dsh plugin --profile web add github:BrokenDreamStar/dsh-skills-mcp

验证安装

dsh --profile web --dump-config | grep -A3 'id: dsh-skills-mcp'

Skills

文件格式

支持两种形式，与 DSH 原生 provider 一致：

• 目录 bundle：/SKILL.md
• 单文件：.md

扫描的根目录（DSH 原生 provider 的同一组）：

来源	系统级	项目级
DSH	$DSH_HOME/skills	`
/.dsh/skills`
Shared Agents	$AGENTS_HOME/skills	`
/.agents/skills`

$AGENTS_HOME 默认为 ~/.agents，可用环境变量覆盖。DSH 根的 .system 子目录不会纳入管理；指向根目录外的符号链接技能会列出并显示为只读，编辑和删除会被拒绝。

SKILL.md 必须以 YAML frontmatter 开头，至少包含：

---
name: my-skill
description: 这个技能做什么、何时使用。
whenToUse: 可选，补充触发场景。
---

### 配置文件格式

```json
{
	"mcpServers": {
		"filesystem": {
			"transport": "stdio",
			"command": "npx",
			"args": ["-y", "@modelcontextprotocol/server-filesystem", "/path"],
			"env": { "TOKEN": "..." },
			"cwd": "/optional/cwd",
			"toolCallTimeoutMs": 60000
		},
		"remote": {
			"transport": "streamable-http",
			"url": "https://example.com/mcp",
			"headers": { "Authorization": "Bearer ..." }
		},
		"disabled-server": {
			"transport": "stdio",
			"command": "node",
			"args": ["server.js"],
			"disabled": true
		}
	}
}

• transport 也接受 type，HTTP 别名 http。
• 项目级 stdio 未填 cwd 时默认使用项目根；系统级默认交给官方 client（空 cwd）。
• 未识别的条目字段会原样保留；顶层 mcpServers 之外的内容也会保留。
• 保存前自动写 mcp.json.bak，新文件权限为 0600。
• 同一作用域内 serverName 必须唯一；项目级与系统级同名会拒绝加载项目级条目。