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

skill-builder

智能体与模型

查看项目

更新于 10-16 04:36

技能介绍

用途

Skill Builder 是一个帮助用户创建结构良好的 Claude Code Skills 的技能。当用户想要为 Claude Code 构建新技能时使用它。

在以下情况调用此技能：

  • 用户想要创建新的 Claude Code Skill
  • 用户询问如何构建或组织技能
  • 用户需要关于技能 frontmatter 或组织方式的帮助
  • 用户想要验证已有技能的结构

主要能力

Skill Builder 提供一套技能创建工作流，覆盖从需求理解到验证测试的完整过程：

  1. 理解需求：通过提问明确技能用途、触发时机、作用范围（项目专属还是个人/通用）以及所需资源（模板、脚本、参考数据等）。
  2. 确定技能位置：根据范围选择目录——项目专属放在项目根目录下的 .claude/skills/[skill-name]/，个人/通用放在 ~/.claude/skills/[skill-name]/。
  3. 创建目录结构：采用包含 SKILL.md（必需）、REFERENCE.md、FORMS.md、scripts/、resources/ 等可选文件的模式。
  4. 编写 SKILL.md：要求包含 YAML frontmatter（name 和 description）以及正文说明，正文建议包含 When to Use、How It Works、Examples 等部分。
  5. 添加支持文件：按需创建 REFERENCE.md（详细技术信息）、FORMS.md（模板与结构化格式）、scripts/（可执行代码）、resources/（静态文件与模板）。
  6. 验证技能：检查 frontmatter、命名、描述、内容结构、token 数量、支持文件、脚本目录、行业标准、示例、自然语言关键词等，并可运行 python .validation/validate-skills.py 进行自动验证。
  7. 测试技能：确认技能可被发现、用示例任务触发、资源正确加载、指令清晰完整。

使用方式

Skill Builder 以技能形式提供，在用户提出创建或验证 Claude Code Skill 相关请求时被调用。其工作流包括：收集信息、规划结构、创建目录、编写 SKILL.md、添加支持文件、验证、向用户说明如何测试和使用，并提供所创建技能的完整路径。

Frontmatter 要求

  • name：最多 64 个字符，仅允许小写字母、数字和连字符（例如 "excel-automation"）。
  • description：非空，最多 1024 个字符，应清晰说明何时使用该技能。
  • 重要：同时包含自然语言和技术关键词。自然语言指非技术用户描述方式（如 "fix broken code"、"save data"、"put online"），技术术语指开发者使用的行话（如 "debug"、"database schema"、"deploy"）。

指令最佳实践

  • 像"新团队成员的入职指南"一样编写
  • 使用清晰的逐步流程
  • 包含上下文示例
  • 引用支持文件而非嵌入所有内容
  • 指令保持在 5k token 以内以便高效加载
  • 使用渐进式披露：在 REFERENCE.md 中引用详细信息

渐进式披露策略

  • 始终加载（元数据）：约 100 token，仅 YAML frontmatter
  • 触发时加载（指令）：少于 5k token，来自 SKILL.md 正文的核心流程
  • 按需加载（资源）：无 token 成本，Claude 通过 bash 命令读取的文件、执行的脚本、访问的模板

验证评分（共 29 分）

  • SKILL.md 存在：1 分
  • 有效 frontmatter：3 分
  • 名称验证：2 分
  • 描述验证：3 分
  • 内容结构：5 分
  • Token 数 <5000：2 分
  • 支持文件：3 分
  • scripts 目录：2 分
  • 行业标准：3 分
  • 示例：2 分
  • 自然语言关键词：3 分（新增）
  • 通过阈值：80%（24/29 分）

适用场景

  • 用户想要创建新的 Claude Code Skill
  • 用户询问如何构建或组织技能
  • 用户需要关于技能 frontmatter 或组织方式的帮助
  • 用户想要验证已有技能的结构

常见技能模式

  • 文档生成技能：doc-generator/ 包含 SKILL.md（生成指令）、templates/（文档模板）、scripts/（格式化脚本）。
  • 代码分析技能：code-analyzer/ 包含 SKILL.md（分析流程）、REFERENCE.md（模式定义）、scripts/（分析工具）。
  • 自动化技能：automation-helper/ 包含 SKILL.md（自动化工作流）、FORMS.md（配置模板）、scripts/（自动化脚本）。

限制

  • 无互联网/API 依赖（Claude Code 约束）
  • 仅使用预安装的包
  • 需避免常见错误：技能名使用大写或特殊字符、描述过于模糊或过长、将所有内容嵌入 SKILL.md 而不使用支持文件、引用不存在的文件、假设可访问互联网或外部 API、创建过于复杂而应拆分的技能、忘记包含"何时使用"的指导

参考文件

templates 目录包含：基础技能模板、带支持文件的高级技能模板、常见用例的示例技能。