个人技能构建器
创建小而精、易于发现的技能，以改善代理在特定可重复工作流中的决策。
作用域
使用本技能来构建新技能或对现有技能进行有针对性的修改。保留用户指定的位置、调用策略和授权边界。不要仅仅为了存放代理已知的通用建议而创建技能。
工作流程
-
在编写文件之前定义任务边界：
- 该技能提供哪些可重复的结果？
- 哪些请求应激活它，哪些类似请求不应激活？
- 重要的输入、工具、副作用和完成检查是什么？
-
在更改现有技能之前，先对其进行检查。保留有用的资源和策略；不要重新初始化现有目录。
-
选择最小的结构：
SKILL.md是必需的。- 仅当存在大量、有条件的、能改变决策的材料时，才添加
references/。 - 仅当存在重复性或确定性工作且执行能提高可靠性时，才添加
scripts/。 - 仅当存在用于生成输出的文件时，才添加
assets/。
-
编写
SKILL.md：- Frontmatter 的
name必须是小写连字符形式，与目录名称匹配，且最多64个字符。 description必须同时说明技能的功能及其适用场景；包含一个边界条件以防止错误路由。- 正文应聚焦于结果、非显而易见规则、执行顺序、确认点和完成检查。
- 将条件细节放在链接的资源中，并明确说明何时阅读它。
- Frontmatter 的
-
如果环境提供了技能验证器（在已安装的
skill-creator技能下找到quick_validate.py），则用其验证结果：python3 <skill-creator>/scripts/quick_validate.py /path/to/skill如果验证器不可用，则手动执行等效的frontmatter、命名、资源链接、占位符和脚本检查。在可行时运行添加的脚本。
设计规则
- 将描述视为路由条件，而非功能目录。
- 使共享指令足够简短，以便常规加载；不要将完整的外部规范复制到入口点。
- 优先使用显式的作用域和可观察的完成标准，而非宽泛的禁止或模糊的质量形容词。
- 如果没有具体的工作流使用它们，不要添加README文件、示例、模板或资源目录。
- 在更新技能时，保留已有的支持的frontmatter和
agents/openai.yaml字段。 - 除非用户明确要求仅显式调用，否则保持自动发现启用。
参考资料
当对可移植性、frontmatter字段、命名限制或加载行为不确定时，请阅读 Agent技能规范。将用户提供或机器本地的设计指南视为可选偏好来源：仅在用户明确要求这些约定或任务依赖于它们时才阅读，并且不要将其完整内容复制到技能中。对于初始化器、UI元数据或验证细节，应咨询已安装的 skill-creator 技能，而非依赖于特定机器的绝对路径。