SuperAPI AI 工具集

qe-skill-builder

智能体与模型

查看项目

更新于 10-16 03:48

技能介绍

用途:帮助创建生产可用的 Claude Code Skills,规范 YAML frontmatter、渐进式披露架构与文件/目录结构,使 Claude 能在各平台(Claude.ai、Claude Code、SDK、API)自主发现并调用技能。

前提:Claude Code 2.0+ 或支持 Skills 的 Claude.ai,了解 Markdown 与 YAML,并具备文本编辑器。

快速开始:

mkdir -p ~/.claude/skills/my-first-skill

然后在 SKILL.md 中按要求填写 name 与 description 字段,重启 Claude Code 或刷新 Claude.ai 即可检测。

主要能力:

  1. 规定 SKILL.md 必需的 YAML frontmatter,仅 name(最多64字符)与 description(最多1024字符,需包含“做什么”和“何时使用”);额外字段会被忽略。
  2. 说明技能目录位置:个人技能放 ~/.claude/skills/[skill-name]/,项目技能放 .claude/skills/[skill-name]/,且必须为顶层目录,不支持嵌套子目录或命名空间。
  3. 解释三级渐进式披露:元数据始终加载;SKILL.md 正文在触发时加载;引用文件按需加载,从而装100+技能仅约6KB上下文。
  4. 建议 SKILL.md 分四级结构:概览、快速开始、详细步骤、参考;并建议正文保持约2–5KB,长内容外链到 docs/ 或 resources/。
  5. 支持 scripts/(如 setup.sh、validate.js)与 resources/(templates、examples、schemas)等目录,供脚本与引用文件使用。
  6. 提供基础、中级、高级三类模板与发布前校验清单,覆盖 frontmatter、结构、内容、渐进披露与测试。

使用方式:按目录结构创建技能,编写规范的 SKILL.md,通过 Markdown 链接或相对路径引用附属文件,重启或刷新后验证触发。

适用场景:为团队或个人沉淀可复用工作流、项目专用工具与共享知识。

限制:资料未提供版本兼容细节、收费与价格信息;技能必须置于顶层目录;YAML 中含特殊字符的字段需加引号,否则会解析出错。