跳过主要内容
全部文档

安装技能

安装 Edaskills 技能的三种方式——ZIP 下载、edaskills CLI,或从你的 agent 通过 MCP 安装。

安装技能

每个 Edaskills 技能都以带版本的 ZIP 发布,内含 SKILL.md、参考文档、脚本,以及 (在执行过演示运行时)演示报告。你有三种安装方式,按自己的工作习惯选择。

1. 下载 ZIP(网页)

在任意技能详情页打开 ZIP 标签下载包。ZIP 保留版本外层目录 (<slug>-<version>/),便于人工归档。下载需要登录账号;访客会被引导登录后返回 原页面。

ZIP 标签同时显示包的校验和(sha256)与大小,便于核对下载内容。

2. 用 CLI 安装

CLI 会下载、校验校验和、安全解压、拍平版本目录,并把技能落到你的 agent 读取的 位置。无需网页登录即可使用。

npx edaskills install <slug>

锁定版本并指定 agent:

npx edaskills install <slug>@1.0.0 --agent claude_code

常用参数:

  • --agent <claude_code|cursor|codex|gemini_cli>——选择宿主适配器。
  • --dir <path>——安装到项目目录而非用户级。
  • --no-demo——跳过 demo-run/ 产物。
  • --yes——跳过指针文件的 diff 确认(用于 CI)。

CLI 不会静默覆盖你的文件。目标目录已存在时会中止并建议改用 edaskills update; update 与 --force 都会先把旧目录备份(.bak-…)再写入。卸载只删除 ~/.edaskills/installed.json 记录在案的目录。

各宿主究竟从哪里读取技能,见逐 agent 指南:

3. 从 agent 安装(MCP)

Edaskills 提供远程 MCP 端点 https://edaskills.com/api/v1/mcp。你的 agent 可以 发现技能、读取内容并请求安装计划。MCP 不会写你的磁盘——它返回计划与一次性 下载链接,由 CLI(或你)完成实际落地。

在 设置 → API 密钥 创建密钥,通过 EDASKILLS_API_KEY 环境变量以 Bearer 令牌 传入。切勿把明文密钥写进配置文件或提交进仓库。

Claude Code(.mcp.json)与 Cursor(mcp.json)可直接配 HTTP:

{
  "mcpServers": {
    "edaskills": {
      "type": "http",
      "url": "https://edaskills.com/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${EDASKILLS_API_KEY}"
      }
    }
  }
}

仅支持 stdio 的宿主(例如 Claude Desktop)用 mcp-remote 桥接:

npx -y mcp-remote https://edaskills.com/api/v1/mcp \
  --header "Authorization: Bearer ${EDASKILLS_API_KEY}"

--header 的值含空格,须整体加引号。${EDASKILLS_API_KEY} 由宿主环境展开。

关于验证徽章

宿主兼容徽章表示该技能的演示运行确实在该宿主上执行过。目前还没有任何宿主的实测 记录,因此技能暂不打宿主徽章。上面的安装约定描述的是 Edaskills CLI 当前的行为, 并不代表某个宿主已经过端到端实测。