工具与生态
围绕 Agent Skills 已经形成相对完整的开放生态：兼容平台、创作工具、校验工具、catalog 索引。本页一次性盘清。
跨平台兼容性
Skill 由 Anthropic 在 2025 年 10 月正式发布，并以 agentskills.io 形式开放为标准。截至 2026 年 5 月，已知支持 Skill 的 Agent 平台：
| 平台 | 来源 | 安装位置 | 备注 |
|---|---|---|---|
| Claude Code | Anthropic | ~/.claude/skills/ / <project>/.claude/skills/ | 首发原生支持 |
| Claude.ai | Anthropic | Settings > Capabilities > Skills（GUI 上传） | 付费计划默认开启 |
| Claude API | Anthropic | API 直传 / 远程 URL | 可用于 Managed Agents |
| OpenAI Codex CLI | OpenAI | ~/.codex/skills/ / <project>/.codex/skills/ | 2026 年加入；支持 $skill 显式调用 |
| ChatGPT | OpenAI | GPT Apps 形式 | 社区适配中 |
| Cursor | Cursor | .cursor/skills/ | 按 spec 兼容 |
| Windsurf | Windsurf | 内置规范支持 | 按 spec 兼容 |
| CodeBuddy | 腾讯 | ~/.codebuddy/skills/ / <project>/.codebuddy/skills/ | 国内常用 |
| Goose | Block | 按 spec 兼容 | 开源 agent |
| Gemini CLI | 按 spec 兼容 | — | |
| Roo Code / Trae / Amp / Factory | 社区/厂商 | 按 spec 兼容 | — |
| GitHub Copilot in VS Code | 微软 | 需要 catalog 适配 | 社区有 .github/skills/ + catalog table 方案 |
TIP
跨平台守则：只要遵守 agentskills.io 规范，一份 Skill 写好后绝大多数主流 Agent 平台都能直接识别。各家差异主要集中在「安装路径」与「工具白名单语法」上。
创作与编辑工具
skill-creator（Anthropic 官方）
最权威的创作工具——Anthropic 出品的"用 Skill 写 Skill"工具。它本身就是一份 Skill，安装后你只需在对话里说："Use the skill-creator skill to help me build a skill for [your use case]"，就能：
- 通过交互式问答收集需求
- 自动生成符合 spec 的 SKILL.md 骨架（含 frontmatter + SOP + 示例）
- 建议触发关键词与典型用户表述
- 输出完整的目录结构（含
scripts//references//assets/）
安装：
npx skills add --skill skill-creator或直接访问 https://claude.com/plugins/skill-creator。
命令行：npx skills add
社区工具，从远程 URL 一键拉取 Skill：
# 安装单个 skill
npx skills add --skill webapp-testing
# 从 git 仓库安装
npx skills add https://cnb.cool/cnb/skills/cnb-skill.git --agent codebuddy
# 安装到指定 agent
npx skills add --skill pdf-form-filler --agent claude-code支持的 agent 包括 claude-code、codex、cursor、codebuddy 等，由 --agent 参数指定安装路径。
IDE 集成
主流 IDE 已陆续提供 Skill 编辑增强：
- Claude Code：内置 skill 创建命令
/skill new、跳转、引用补全 - VS Code + Continue.dev：Skill 浏览器与编辑面板
- Cursor：
.cursor/skills/目录有专门 lint 提示
校验工具
写完 Skill 后，建议跑一次自动化校验。
skills-ref（agentskills.io 官方）
agentskills.io 官方校验器，检查 frontmatter 语法、字段约束、命名规范：
skills-ref validate ./my-skill输出例：
✓ name field valid (matches directory)
✓ description length within 1024 chars
✗ Found README.md in skill directory — recommend removing
✗ scripts/helper.py uses Windows-style pathskillgrade（社区）
更高阶的"质量评分"工具：
- 用 LLM 隔离评估 description 是否会过/欠触发
- 跑预设的 SkillsBench 测试集
- 输出 0-100 分质量分
评估方法论
写完不等于写好。建议参考 写好 description · 触发率评估 介绍的三步流程：
- 建评估集：10–20 条 should-trigger + 5–10 条 should-not-trigger，用真实用户表述
- 跑触发率：每条 query 跑 3+ 次取触发率，>0.5 视为触发
- 迭代：失败的 query 是黄金信号——把缺漏关键词补回 description
Anthropic skill-creator 内置了这套评估的自动化版本——它会基于你的 description 生成测试 query，跑通后再交付，省去手工跑 60 次 LLM 调用。
知名 Catalog
读完文档想看更多优秀 Skill 范例时，按以下顺序探索：
一手官方仓库
| 仓库 | 内容 | stars |
|---|---|---|
| anthropics/skills | Anthropic 官方示例库；含 PDF / DOCX / PPTX / XLSX 处理、skill-creator、frontend-design、webapp-testing 等 | 73k+ |
| openai/skills | OpenAI Codex 官方示例 | — |
| agentskills/agentskills | 开放标准本身的源码 + 参考实现 | — |
社区聚合（awesome 系列）
| 仓库 | 定位 |
|---|---|
| ComposioHQ/awesome-claude-skills | Claude 生态聚合，含简历分析、营销分析、PR 审查等 |
| kodustech/awesome-agent-skills | 跨平台聚合，含各平台 known-pitfalls Skills |
| mgechev/skills-best-practices | 专业级 Skill 创作指南，可作辅读资料 |
中文社区
| 入口 | 内容 |
|---|---|
| CNB Skills 仓库 | CNB 平台官方 Skill 集（含 cnb-skill 等） |
| Anthropic 中文课程 | Anthropic 官方 Agent Skills 入门课程 |
安全话题
WARNING
Skill 是可执行内容——尤其包含 scripts/ 时。从社区或第三方安装 Skill 前：
- 审查 SKILL.md——看它会让 agent 做什么、用什么工具
- 审查
scripts/——脚本会真正执行，与运行你下载的 shell 脚本风险等级相同 - 审查
allowed-tools——是否声明了你不希望授予的能力（如Bash(rm:*)） - 沙箱测试——首次使用建议在隔离环境（容器 / 临时目录）里跑一次
TIP
企业部署可启用 Anthropic 在 2025-12 上线的 组织级管理，由管理员预审 Skill 后再下发，集中控制。
下一步
- 想立刻动手？→ 快速开始
- 不太确定 description 怎么写？→ 写好 description
- 写完想自查？→ 反模式 checklist