Skill 生态
Vercel Skills / Anthropic 官方 skill 标准 + 一份 skill 跨 14 平台部署的工具链。
这个 pack 装了什么
Skill 是 Anthropic 在 2025 年底标准化的格式 —— 一个文件夹装一个 SKILL.md + 可选脚本 / 引用 / 模板,用来分发可复用的 agent 能力。Vercel 等也采用了同一标准。这个 pack 收齐 七个资产,让你写一次 skill 就能在整个 AI 工具生态里上线。
| # | 资产 | 层 | 为什么收 |
|---|---|---|---|
| 1 | Anthropic skill 格式规范 | 标准 | SKILL.md 规范模式 |
| 2 | Vercel Skills | 实现 | 跨模型 skill 运行时(AI SDK) |
| 3 | Skill Maker | 工具 | 用正确元数据搭新 skill 脚手架 |
| 4 | Skill → Cursor 规则转换器 | 工具 | 一份 skill,输出 .mdc |
| 5 | Skill → AGENTS.md 转换器 | 工具 | 给 Codex CLI 项目 |
| 6 | Skill 注册中心模式 | 基建 | HTTP 端点托管私有 skill |
| 7 | 14 目标部署矩阵 | 参考 | 哪个表面接哪部分 skill 特性 |
为什么要装
skill 标准之前,每个 AI 工具都想用自己方言描述同一能力:Cursor 规则是 .mdc、Claude Code subagent 是带 frontmatter 的 Markdown、Codex CLI 项目要 AGENTS.md、Cline 规则在 .clinerules。同一个逻辑 skill(比如「审代码安全问题」)要手翻 14 次。
skill 标准用一份规范格式 + 工具层产生各工具变体,解决这个问题。三个具体收益:
- 单一真相源。每个能力你写一份
SKILL.md进版本控制。审查、修改、changelog 全在一个地方。 - 机械翻译,不是复制粘贴。转换器工具从规范 skill 生成 Cursor
.mdc/ CodexAGENTS.md/ Cline 规则等。平台间不漂移。 - agent 层可组合。Anthropic 运行时能把多个 skill 加载进同一个 Claude 会话。Vercel AI SDK 实现跨模型供应商做同样事。今天写的 skill 两年后底层模型换了还能用。
一条命令装齐
# 装整个 pack
tokrepo install pack/skills-ecosystem
# 或者先装单件
tokrepo install skill-maker
tokrepo install vercel-skills
TokRepo CLI 把 skill 脚手架、转换器脚本、起步 SKILL.md 模板丢进项目。一条命令出一个能编译 14 目标的 skill。
常见坑
- 把
SKILL.md当 prompt 模板。不是 —— 它是带元数据 / 允许工具 / 渐进式披露引用的能力声明。当成内部文档页写,不是当成 LLM prompt 写。 - skill 主体里塞密钥。skill 设计成可入公开 repo。密钥用环境变量或运行时注入;绝不粘贴。
- 跳过
description字段。agent 用 description 决定一次查询是否加载这个 skill。description 含糊就永远不会被用上。范围和触发条件要具体。 - 忘了各目标特性矩阵。Cursor
.mdc支持 glob 范围。CodexAGENTS.md是项目级。Claude Code subagent 有 allowed-tools。转换器出最接近等价物,但你写的时候要心里有数。 - 想给所有工具用却只给一个工具写。能力可移植(审代码 / 总结文档 / 生成测试)就第一天按 skill 写。工具专用(直接用 Anthropic 工具 API 的 Claude Code 插件)再写工具专用资产。
跟其他 pack 的关系
Anthropic 开发栈 pack 出 17 个 Anthropic 第一方 skill 建立规范模式。写自己的时候参考这些。Claude Code 子代理精选 pack 是把 skill 装进 Claude Code 会话的运行时层 —— 你写好 skill 后真在跑的就是它。这个 Skill 生态 pack 聚焦跨平台翻译层:怎么把 skill 在 Cursor / Codex CLI 等工具里跑通。
对于还没原生支持 skill 格式的工具,转换器输出会带「垫片」资产(用户粘进工具上下文的 Markdown 文件),让不支持的表面也能拿到大部分价值。
7 个资产打包就绪
常见问题
skill 用起来免费吗?
skill 格式规范开放免费。Anthropic 官方 skill 是 MIT 协议,可自由 fork。Vercel AI SDK 在 SDK 层免费(按 token 付底层模型供应商)。TokRepo 装的工作脚手架零成本进项目 —— 你付的就是模型 API 账单,用 skill 还是写内联 prompt 都一样。
skill 跟 Cursor 规则比怎么样?
Cursor 规则(.mdc 文件)是 Cursor 专用指令 —— 只在 Cursor 里管用。skill 是跨平台抽象。你的 SKILL.md 是源;TokRepo 转换器生成 Cursor 要的 .mdc,加上 Codex CLI / Cline / Roo Code 等的等价物。只用 Cursor 就原生 .mdc 行;用两个或更多工具就写 skill。
用 Cursor 或 Codex CLI 也能用吗?
本来就是这意思 —— 能。skill 标准就是奔着多工具现实来的。转换器输出给 Cursor 的 .mdc、给 Codex CLI 的 AGENTS.md,加上 Cline / Roo Code / Windsurf / GitHub Copilot / Claude Code subagent 的各工具变体。写一次;通过 tokrepo deploy 部署到 14 目标。
这个 pack 跟 Anthropic 开发栈 pack 啥区别?
Anthropic 开发栈是 17 个 Anthropic 官方 skill 的目录(PDF 阅读 / 文件管理 / 网页抓取等)—— 装即用的成品能力。Skill 生态是元包:格式规范 / 写作工具 / 跨平台转换器 / Vercel 实现。Anthropic 开发栈装现成 skill;Skill 生态用来写和部署你自己的。
目标工具不支持我 skill 里要的特性怎么办?
转换器检测到不支持的特性会优雅降级(比如目标工具不支持 scoping 时把 glob 范围规则丢掉)或发警告。14 目标部署矩阵资产精确文档化每个工具支持哪些特性,你写之前就能决定要做完全可移植的 skill 还是接受某能力不能各处都行。