zed-skills

在 Zed 中直接使用你的 AI 编程工具 skills — 无需复制粘贴，无需手动配置。

English | 简体中文

解决什么问题

Claude Code、Codex、OpenClaw、Cursor 等 AI 编程工具支持 skills — 基于 Markdown 的指令文件（SKILL.md），赋予 AI 可复用的专项能力（数据库查询、前端设计、GitHub 工作流等）。

Skills 可能存放在多个位置，而 Zed 内置的 AI 对这些位置一无所知：

工具专属目录 — 为某个工具安装的 skills：

~/.claude/skills/my-skill/SKILL.md
~/.codex/skills/my-skill/SKILL.md

项目目录 — 提交到代码仓库、与团队共享的 skills：

your-project/.claude/skills/my-skill/SKILL.md
your-project/.agents/skills/my-skill/SKILL.md

Skills 管理器 — 如 CC Switch，维护一份统一的 skills 库并通过软连接同步到各工具：

~/.cc-switch/skills/my-skill/SKILL.md   ← 唯一来源
~/.claude/skills/my-skill  →  软连接
~/.codex/skills/my-skill   →  软连接

当你使用 Zed 作为编辑器时，其内置的 AI 无法发现上述任何位置的 skills，积累的知识对它来说完全不可见。

解决方案

zed-skills 是一个 MCP 服务器，用于弥合这一差距。它扫描上述所有位置，并将每个 skill 作为独立的 MCP 工具暴露给 Zed。你现有的 skills 立即可用 — 无需重复维护，无需手动配置。

工作原理

zed-skills 扫描已知的 skills 目录，将每个 skill 作为独立的 MCP 工具暴露给 Zed。当同名 skill 存在于多个目录时，优先级更高的目录胜出。

Skills 是动态发现的 — 在任意目录新增 skill 后，下一次 Zed 对话就会自动出现，无需重启。

内置目录

按优先级从高到低扫描：

| 优先级 | 目录 | 来源 | |--------|------|------| | 1 | {project}/.claude/skills/ | 项目级（Claude） | | 2 | {project}/.agents/skills/ | 项目级（通用） | | 3 | {project}/.skills/ | 项目级（通用） | | 4 | ~/.cc-switch/skills/ | CC Switch | | 5 | ~/.claude/skills/ | Claude Code | | 6 | ~/.codex/skills/ | Codex (OpenAI) | | 7 | ~/.openclaw/skills/ | OpenClaw | | 8 | ~/.config/opencode/skills/ | OpenCode | | 9 | ~/.cursor/skills/ | Cursor | | 10 | ~/.windsurf/skills/ | Windsurf | | 11 | ~/.gemini/skills/ | Gemini CLI | | 12 | ~/.kiro/skills/ | Kiro | | 13 | ~/.trae/skills/ | Trae | | 14 | ~/.copilot/skills/ | GitHub Copilot CLI | | 15 | ~/.pi/skills/ | Pi (pi-mono) | | 16（最低）| ~/.agents/skills/ | 通用 agents |

{project} 为 Zed 启动 MCP 服务器时的工作目录（通常是项目根目录）。自定义路径（见下文）始终优先级最高。

安装

方式一：npx（推荐，无需安装）

在 ~/.config/zed/settings.json 中添加：

{
  "context_servers": {
    "zed-skills": {
      "command": "npx",
      "args": ["-y", "zed-skills"]
    }
  }
}

方式二：全局安装

npm install -g zed-skills

然后在 ~/.config/zed/settings.json 中添加：

{
  "context_servers": {
    "zed-skills": {
      "command": "zed-skills",
      "args": []
    }
  }
}

自定义路径

可以追加任意数量的额外 skills 目录。自定义路径始终比内置目录优先级高。

多个 --dirs 参数（最清晰）

{
  "context_servers": {
    "zed-skills": {
      "command": "npx",
      "args": ["-y", "zed-skills", "--dirs", "/team/skills", "--dirs", "/project/skills"]
    }
  }
}

冒号分隔（Unix）/ 分号分隔（Windows）

{
  "context_servers": {
    "zed-skills": {
      "command": "npx",
      "args": ["-y", "zed-skills", "--dirs", "/team/skills:/project/skills"]
    }
  }
}

环境变量

{
  "context_servers": {
    "zed-skills": {
      "command": "npx",
      "args": ["-y", "zed-skills"],
      "env": { "ZED_SKILLS_DIRS": "/team/skills:/project/skills:/another/path" }
    }
  }
}

三种方式可以混用。解析顺序：--dirs 参数 → ZED_SKILLS_DIRS 环境变量 → 内置目录。

Skill 格式

每个 skill 存放在独立子目录中，需包含一个 SKILL.md 文件：

~/.claude/skills/
└── my-skill/
    └── SKILL.md

SKILL.md 必须包含 YAML frontmatter，至少有 name 和 description 字段：

---
name: my-skill
description: 简短描述这个 skill 的功能及适用场景。
---

# My Skill

告诉 AI 如何执行这个 skill 的具体指令...

环境要求

• Node.js >= 16
• Zed 编辑器

开源协议

MIT