用途:Skill Builder 帮助创建生产可用的 Claude Code Skills,生成规范的 YAML frontmatter、渐进式披露架构以及完整的文件与目录结构,使技能可被 Claude 在 Claude.ai、Claude Code、SDK、API 等界面自主发现并使用。
主要能力:每个 SKILL.md 必须以 YAML frontmatter 开头,且只包含两个必填字段:name(最长 64 字符)与 description(最长 1024 字符,需同时说明做什么和何时使用)。技能目录必须直接位于 ~/.claude/skills/[skill-name]/ 或项目根目录 .claude/skills/[skill-name]/ 下,不支持嵌套子目录或命名空间。推荐结构包含 SKILL.md、README.md、scripts/、resources/(templates、examples、schemas)和 docs/。
使用方式:创建技能目录后写入 SKILL.md,例如 mkdir -p ~/.claude/skills/my-first-skill,再创建带 frontmatter 的 SKILL.md,最后重启 Claude Code 或刷新 Claude.ai 以检测技能。个人技能放在 ~/.claude/skills/,项目技能放在 .claude/skills/ 并应提交到 git。
渐进式披露:分三级加载。第一级为元数据(名称与描述),启动时始终加载,约 200 字符/技能;第二级为 SKILL.md 正文,技能触发时加载,通常 1-10KB;第三级为引用文件,按需加载。建议 SKILL.md 保持精简(约 2-5KB),长内容移至独立文件并引用。
适用场景:构建个人生产力工具、团队共享工作流、项目专用工具与共享知识。
限制:仅 name 和 description 会被 Claude 使用,额外字段会被忽略;目录必须为顶层结构;需 Claude Code 2.0+ 或支持 Skills 的 Claude.ai;需了解 Markdown 与 YAML。