SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场skill builder

skill builder

智能体与模型

查看项目

更新于 10-16 17:38

技能介绍

用途

Skill Builder 用于创建可生产使用的 Claude Code Skills，具备规范的 YAML frontmatter、渐进式披露（progressive disclosure）架构以及完整的文件/文件夹结构。该技能会引导你构建 Claude 能够自主发现并在各平台（Claude.ai、Claude Code、SDK、API）使用的技能。

前提条件

  • Claude Code 2.0+ 或支持 Skills 的 Claude.ai
  • 对 Markdown 和 YAML 有基本了解
  • 文本编辑器或 IDE

主要能力

YAML Frontmatter 规范

每个 SKILL.md 必须以 YAML frontmatter 开头，且仅包含两个必填字段：

  • name（必填）：字符串，最大 64 字符，人类友好的展示名称，建议使用 Title Case。
  • description（必填）：字符串，最大 1024 字符，必须同时说明技能做什么（功能）以及 Claude 何时应调用它（触发条件）。

注意：只有 name 和 description 会被 Claude 使用，其他字段会被忽略。

目录结构

技能必须直接位于 ~/.claude/skills/[skill-name]/ 或 <project-root>/.claude/skills/[skill-name]/ 下，Claude Code 不支持嵌套子目录或命名空间。

最小结构仅需 SKILL.md。完整结构可包含 README.md、scripts/、resources/（含 templates/、examples/、schemas/）、docs/ 等目录。

技能位置分为两类：

  • 个人技能：~/.claude/skills/，适用于该用户所有项目，不提交到 git。
  • 项目技能：项目根目录下的 .claude/skills/，仅适用于该项目，应提交到 git 供团队共享。

渐进式披露架构

采用 3 级渐进式披露系统，以便在无上下文负担的情况下扩展到 100+ 技能：

  • 第 1 级：元数据（name + description），在 Claude Code 启动时始终加载，每个技能约 200 字符，用于自主技能匹配。
  • 第 2 级：SKILL.md 正文，在技能被触发/匹配时加载，通常约 1-10KB，包含主要指令和流程。
  • 第 3 级及以上：引用文件，按需加载，大小可变，用于深度参考、示例和 schema。

SKILL.md 内容结构

推荐 4 级结构：

  • 第 1 级：概览（Overview），始终首先阅读，包含 2-3 句简介、前提条件和功能说明。
  • 第 2 级：快速开始（Quick Start），用于快速上手，包含基本用法和常见场景。
  • 第 3 级：详细说明（Detailed Instructions），用于深入工作，包含分步指南和高级选项。
  • 第 4 级：参考（Reference），较少需要，包含故障排查、API 参考、示例和资源链接。

脚本与资源

  • scripts/ 目录：供 Claude 运行的可执行脚本，如 setup.sh、validate.js、generate.py、deploy.sh，从 SKILL.md 中引用。
  • resources/ 目录：模板、示例、schema 和静态文件，如 templates/、examples/、schemas/。

文件引用与导航

Claude 可自动导航到被引用的文件。可使用 Markdown 链接、相对文件路径或内联文件内容。最佳实践是保持 SKILL.md 精简（约 2-5KB），将冗长内容移至单独文件并按需引用。

使用方式

创建第一个技能的基本步骤（以命令形式给出）：

创建技能目录（必须在顶层，不能在子目录中）： mkdir -p ~/.claude/skills/my-first-skill

创建 SKILL.md 并写入规范格式内容。

重启 Claude Code 或刷新 Claude.ai 以验证技能是否被检测到。

校验清单

发布技能前需验证：

  • YAML frontmatter：以 --- 开头和结尾，包含 name（≤64 字符）和 description（≤1024 字符），description 包含 what 和 when，无 YAML 语法错误。
  • 文件结构：SKILL.md 存在，目录直接位于 ~/.claude/skills/[skill-name]/ 或 .claude/skills/[skill-name]/，目录名清晰具描述性，无嵌套子目录。
  • 内容质量：各级内容清晰、示例具体可运行、包含故障排查。
  • 渐进式披露：核心指令在 SKILL.md，高级内容在 docs/，大型资源在 resources/。
  • 测试：技能出现在列表中，description 能在相关查询时触发，指令清晰可操作，脚本成功执行，示例按文档工作。

适用场景

  • 创建新的 Claude Code Skills
  • 标准化技能文件结构与 frontmatter
  • 搭建具备渐进式披露架构的技能
  • 为团队或项目构建可共享的技能

限制

  • 技能必须为顶层目录，Claude Code 不支持嵌套子目录或命名空间。
  • 只有 name 和 description 字段会被 Claude 使用，其他字段被忽略。
  • name 最大 64 字符，description 最大 1024 字符。
  • 需要 Claude Code 2.0+ 或支持 Skills 的 Claude.ai。

（注：资料中未提供具体的收费、价格或平台兼容性细节之外的更多信息。）