自学教程

Skills skill-creator 创建 Skill

Skills 教程

skill-creator 是一款用于自动生成 Skill 的内置技能，它本身就是一个 Skill。借助 skill-creator，开发者不需要从零手动编写完整 SKILL.md，只需要描述想要实现的功能，就能快速生成一套符合规范、可直接使用的 Skill 目录与文件，大幅降低开发新技能的门槛。该项目参考 anthropics/skills 仓库中的 skill-creator 实现。

一、什么是 skill-creator

skill-creator 是专门用来创建其他 Skill 的元技能（meta skill）。
普通 Skill 用来完成业务任务，而 skill-creator 的任务是：接收用户对新技能的需求描述，自动输出标准的 SKILL.md、生成目录结构，甚至可以附带脚本模板。

它遵循整套 Skill 体系的渐进式加载与触发机制，和我们之前学习的 roll-dice 等技能使用方式完全一致。

简单理解：skill-creator 就是一个技能生成器，用技能来创建新技能。

二、skill-creator 的能力

  1. 根据自然语言需求，自动生成 SKILL.md 头部 YAML 元数据（name、description、version、author）
  2. 自动生成 SKILL.md 正文，包含任务目标、触发场景、执行步骤、输出规范
  3. 生成标准目录结构，自动匹配技能文件夹命名规范
  4. 可选生成 scripts 脚本模板，用于后续脚本扩展
  5. 输出可直接保存、加载、测试的完整技能文件，无需手动调整格式

三、skill-creator 工作原理

skill-creator 同样遵循 Skills 的三层渐进式加载机制：

  1. 发现阶段：会话启动时，系统扫描元数据，识别 skill-creator 这个技能，仅读取 name 和 description。
  2. 意图匹配阶段：用户提出“创建一个XX技能”的需求，语义命中 skill-creator 的描述，触发该技能。
  3. 激活执行阶段：加载完整 skill-creator 的 SKILL.md，按照它内部定义的规则，生成新技能的全部内容。

在执行阶段，skill-creator 会解析用户的需求，提取新技能的名称、功能、触发关键词、执行逻辑，最后输出标准化的 SKILL.md 文本。

四、使用 skill-creator 创建 Skill 完整步骤

1. 确认 skill-creator 已加载

把 skill-creator 文件夹放到项目的 .agents/skills/ 目录下。
使用 /skills 指令查看技能列表，确认 skill-creator 已经被系统识别。

目录结构：

.agents/skills/
└── skill-creator/
    └── SKILL.md

2. 调用 skill-creator（两种触发方式）

方式1：自然语言自动触发

直接用自然语言描述你想要创建的技能，示例：

帮我创建一个技能：技能名称为 word-count，功能是统计文本的字数，接收一段文本作为参数，输出总字数。

系统识别意图，自动激活 skill-creator。

方式2：显式手动触发（推荐测试使用）

使用 @skill-creator 强制调用，避免匹配失败：

@skill-creator 创建技能 word-count，用来统计输入文本的字符数量，接收文本参数，输出统计结果。

3. 查看生成结果

skill-creator 会输出完整的 SKILL.md 内容，包含：

  • YAML 头部元信息
  • 任务目标、触发场景
  • 参数定义、执行步骤
  • 输出规范

4. 部署新技能

  1. 在 .agents/skills/ 新建文件夹，文件夹名称和生成内容里的 name 保持一致（word-count）
  2. 将生成的文本保存为 SKILL.md，放入该文件夹
  3. 刷新技能列表，使用 /skills 验证新技能是否被识别
  4. 测试调用新技能，验证参数传递、触发逻辑是否正常

五、使用技巧，让生成的技能质量更高

在描述需求时，尽量提供下面信息，skill-creator 生成的内容会更稳定：

  1. 技能名称
  2. 技能的功能描述（用于 description 触发关键词）
  3. 需要接收哪些参数
  4. 执行步骤（调用终端还是脚本）
  5. 输出格式要求

示例高质量需求描述：

@skill-creator，创建技能 calc-add，用于两数相加。接收参数 num1、num2。执行加法运算，输出计算结果。只返回数字结果，不要多余文字。

六、优势与局限

优势

  1. 快速原型：几分钟生成一个技能原型，省去手动编写 SKILL.md 的重复工作
  2. 规范统一：自动遵守 Skill 目录、YAML、参数占位符规范，减少手写错误
  3. 降低门槛：新手不需要记忆 SKILL.md 的完整结构，用自然语言即可生成技能
  4. 可二次修改：生成的文件可以直接编辑调整，再加入脚本扩展

局限

  1. 生成的内容适合原型，复杂业务场景仍需要人工校验、优化 description、补充脚本
  2. 复杂脚本逻辑不会自动编写，scripts 目录下代码仍需要开发者自己实现
  3. 生成的 description 可能存在关键词不足，需要人工优化，防止误触发或不触发

七、总结

skill-creator 是一个用来创建技能的元技能，它本身也是标准 Skill，完全复用 Skills 的触发机制、渐进式加载机制。开发者只需要用自然语言描述需求，skill-creator 就可以自动生成标准化的 SKILL.md 文件与技能框架。

它适合快速搭建技能原型，减少重复编写配置文件的工作量。生成之后，我们依然需要人工检查、优化触发关键词、补充脚本，完成最终的技能调试。skill-creator 极大提升了 Skill 的开发效率，是批量开发多个技能的有力工具。

标签：

0 条笔记