skill-builder-mcp

skill-builder

从命令行发布和安装 AI 技能提示词，也可以在网页编辑器中借助 AI 起草助手编写提示词。

npx @dmzagent/skill-builder install @author/skill-id

---

开始使用：安装技能

浏览注册表

结果会以紧凑表格的形式直接显示在终端中：

npx @dmzagent/skill-builder list

按类别、作者、类型、标签和排序方式筛选：

npx @dmzagent/skill-builder list --category "Developer Tools"
npx @dmzagent/skill-builder list --type meta          # only meta skills
npx @dmzagent/skill-builder list --author skillauthor
npx @dmzagent/skill-builder list --sort downloads
npx @dmzagent/skill-builder list --json               # machine-readable
npx @dmzagent/skill-builder list --web                # open the browser registry instead

搜索和查看详情

npx @dmzagent/skill-builder search "data pipeline"    # ranked by relevance
npx @dmzagent/skill-builder info @skillauthor/dialogue-flow
npx @dmzagent/skill-builder suggest dial              # autocomplete: skills, tags, authors

设置 Shell 补全（输入时可补全技能、标签和作者）：

npx @dmzagent/skill-builder completion >> ~/.bashrc

安装技能

npx @dmzagent/skill-builder install dialogue-flow
npx @dmzagent/skill-builder install @skillauthor/dialogue-flow

将 dialogue-flow.md 和 dialogue-flow.json 下载到当前目录。使用 --output ./my-skills 可更改文件保存位置。

元技能会自动安装其依赖项。 安装元技能时，会解析其完整依赖树（去重且可安全处理循环依赖），并一并安装所有必需技能。使用 --no-deps 可只安装元技能。

npx @dmzagent/skill-builder install @skillauthor/my-bundle
# → resolves and installs my-bundle + every skill it depends on

---

开始使用：发布技能

1. 创建账户

npx @dmzagent/skill-builder register myhandle "My Name" [email protected]

系统会提示你输入密码。也可以设置 SKILL_PASSWORD 来跳过提示：

SKILL_PASSWORD=hunter2 npx @dmzagent/skill-builder register myhandle "My Name" [email protected]

2. 登录

npx @dmzagent/skill-builder login [email protected]

成功后会显示你的身份验证令牌。将其设置为 SKILL_TOKEN，以便后续命令使用：

export SKILL_TOKEN=<token-from-login>

（或者在每条命令中传入 --token $SKILL_TOKEN。）

3. 发布技能

从 Markdown 文件发布：

npx @dmzagent/skill-builder publish ./my-skill.md

CLI 会将文件名用作技能 ID，并将第一个标题用作名称。你也可以使用 JSON 清单：

npx @dmzagent/skill-builder publish ./my-skill.json

4. 声明技能所需的能力（可选）

技能可以声明模型必须具备哪些能力才能调用它。该声明保存在规范中，因此会随技能一同经过注册表、CLI 和 MCP — Agent 可以在为技能消耗一个回合之前，判断自己是否能够运行该技能。

{
  "capabilities": [
    { "id": "vision", "level": "required", "note": "reads chart images" },
    { "id": "long-context", "level": "preferred" }
  ]
}

required 能力会限制执行：除非调用方明确强制进行降级运行，否则注册表不会在无法提供其中任何一项能力的运行时上运行技能。preferred 能力只会降低结果质量。目录 ID：

vision · audio-input · file-input · structured-output · streaming
extended-reasoning · long-context · multilingual
tool-use · parallel-tool-calls · code-execution · web-search · file-system
computer-use · mcp-client
persistent-memory · citations

目录尚未涵盖的能力也可以使用自定义 ID。info 和 list 会显示此契约，install 则会汇总元技能整个依赖树中的能力要求 — 只有当元技能安装的所有技能都能运行时，元技能才能运行。

npx @dmzagent/skill-builder info @skillauthor/chart-reader
# Required capabilities (1) — the invoking model must provide these:
#   - vision (required) — reads chart images

5. 派生现有技能（可选）

npx @dmzagent/skill-builder fork @skillauthor/dialogue-flow --name my-dialogue

这会在你的账户下创建一个副本，你可以重新发布它。

---

维护注册表：回填依赖项

scripts/backfill-dependencies.mjs 会查找那些隐式编排其他技能的现有技能，并为它们建议显式的 dependencies + type: "meta"。该脚本会读取每项技能，检测对其他实际注册表技能的引用（通过完整 ID、install 指令或有辨识度的名称），评估置信度，并合并一组经过整理的已确认映射。

默认以试运行模式运行 — 只打印报告，不写入任何内容：

node scripts/backfill-dependencies.mjs                 # report only
node scripts/backfill-dependencies.mjs --json          # machine-readable

如需应用更改，请使用带有令牌的 --apply。只会更新令牌所属账户拥有的技能（其他技能会列出并跳过），因此每个发布账户都需要运行一次：

SKILL_TOKEN=<token> node scripts/backfill-dependencies.mjs --apply
node scripts/backfill-dependencies.mjs --apply --include-medium   # also apply medium-confidence

置信度级别：curated 和 high（明确的 ID、安装指令或有辨识度的名称引用）默认应用；medium（模糊名称匹配）仅在使用 --include-medium 时应用；meta-no-deps（包含编排相关措辞，但没有具体依赖项）会报告供人工审核，绝不会自动应用。

应用更改要求注册表运行支持 type/dependencies 的 worker 构建版本（它会推导 type，并在保存时重新生成 Markdown）。 试运行报告适用于任何已部署版本。

---

从编码 Agent 使用（MCP）

编码 Agent——Claude Code、Cursor、Codex 及其他 MCP 客户端——可以通过 @dmzagent/skill-builder-mcp MCP 服务搜索注册表并自动安装技能（解析元技能依赖树）。

// e.g. .mcp.json (Claude Code) or .cursor/mcp.json (Cursor)
{
  "mcpServers": {
    "skill-builder": { "command": "npx", "args": ["-y", "@dmzagent/skill-builder-mcp"] }
  }
}

工具：skill_search、skill_info、skill_suggest、skill_taxonomy 和 skill_install（为检测到的工具写入技能文件）。各客户端的设置说明请参阅 packages/mcp/README.md。

---

Web 应用

访问技能工作室：https://skills.dmzagent.com。工作区由三个可折叠窗格和一个设置抽屉组成：

• 技能架构师 — 直接编辑规范的 Agent，而不是返回 Markdown；它会根据规范尚缺少的内容提供建议的后续步骤。
• 规范画布 — 以文档形式呈现技能：能力契约、说明、高亮显示 {{variables}} 的提示词模板、示例和测试，以及一份发布就绪情况检查清单，其中的链接会指向每个缺口背后的依据。
• 预览 — 实际运行技能。模板变量会变成字段，能力预检会说明运行时能否如实执行该技能，并根据每次运行对应的预期为其评分。任何运行结果都可以交由架构师审查。
• 架构 — 对于元技能，以分层图的形式展示依赖树，并标出未解析的 ID 和循环依赖，同时汇总该技能所安装全部内容的能力契约。
• 设置抽屉 — 收纳规范的所有字段，需要时再查看：身份、行为、能力、组合、示例和测试，以及生成的 Markdown 成品。

从源代码安装

npm install
npm run dev --workspace packages/web

许可证

MIT