skill-creator

用途

Skill Creator 是一个用于指导创建有效 AI 智能体技能（Skill）的技能。当用户想要新建一个技能（或更新已有技能）以扩展 AI 智能体的能力时使用它。它面向的是“技能的编写者”，提供创建技能时所需的结构规范、写作原则与工作流程。

关于技能

技能是模块化、自包含的包，通过提供专门的知识、工作流和工具来扩展 AI 智能体的能力。可以把它理解为特定领域或任务的“上手引导”，将通用型智能体转变为配备程序性知识的专用智能体。

技能可以提供：

专门工作流：针对特定领域的多步骤过程
工具集成：处理特定文件格式或 API 的说明
领域专长：公司特定知识、数据结构、业务逻辑
捆绑资源：用于复杂和重复任务的脚本、参考资料和资产

核心原则

精简是关键。上下文窗口是公共资源，技能会与智能体所需的其他所有内容共享上下文。默认假设是：智能体本身已经非常聪明，只添加它尚不具备的上下文。编写时应质疑每一条信息：“智能体真的需要这个吗？”“这一段是否对得起它的 token 成本？”优先使用简洁示例而非冗长解释。

技能的结构

每个技能由必需的 SKILL.md 文件和可选的捆绑资源组成：

skill-name/
├── SKILL.md (required)
│   ├── YAML frontmatter metadata (required)
│   │   ├── name: (required)
│   │   └── description: (required)
│   └── Markdown instructions (required)
└── Bundled Resources (optional)
    ├── scripts/          - Executable code (Python/Bash/etc.)
    ├── references/       - Documentation loaded into context as needed
    └── assets/           - Files used in output (templates, icons, fonts, etc.)

SKILL.md 包含：

Frontmatter（YAML）：包含 name 和 description 字段，这是决定技能何时被使用的唯一字段，需清晰全面。
正文（Markdown）：使用技能的说明与指导，仅在技能被触发后才加载。

捆绑资源（可选）：

scripts/：用于需要确定性可靠性或被反复重写的任务的可执行代码。当同一段代码被反复重写时加入。示例：用于 PDF 旋转任务的 scripts/rotate_pdf.py。优点是 token 高效、结果确定。
references/：按需加载进上下文的文档和参考资料。供智能体在工作中查阅。示例：references/schema.md 用于数据库结构，references/api_docs.md 用于 API 规范。优点是让 SKILL.md 保持精简，仅在需要时加载。
assets/：不加载进上下文、但用于输出中的文件。当技能需要为最终输出提供文件时加入。示例：assets/logo.png 用于品牌资产，assets/template.html 用于 HTML 样板。

渐进式披露

技能采用三级加载系统：

元数据（name + description）：始终在上下文中（约 100 词）
SKILL.md 正文：技能触发时加载（少于 5000 词）
捆绑资源：按需加载（不限量）

保持 SKILL.md 正文在 500 行以内，接近此上限时将内容拆分到独立文件。

技能创建流程

第一步：理解技能。用具体示例澄清：“这个技能应支持什么功能？”“能举例说明这个技能将如何使用吗？”“什么会触发这个技能？”

第二步：规划可复用内容。分析每个示例：考虑如何从零执行，识别有用的脚本、参考和资产。

第三步：创建技能。创建技能目录（skill-name/ 下含 SKILL.md，必要时含 scripts/、references/、assets/）。

第四步：编写 SKILL.md。

Frontmatter 示例：

---
name: skill-name
description: What the skill does and when to use it. Include specific triggers and contexts. Max 1024 characters.
---

描述撰写规范：同时包含技能做什么和何时使用；包含触发短语；最多 1024 字符，不使用 XML 标签；使用第三人称。

正文：编写使用技能的说明，包括快速开始指南、分步工作流、需要时指向参考文件的链接。

第五步：测试并迭代。在真实任务中使用技能，留意困难或低效之处，据此更新 SKILL.md 或资源，然后再次测试。

质量检查清单

定稿前确认：描述明确说明何时使用（最多 1024 字符）；文件夹名使用 kebab-case；说明可操作且无歧义；范围聚焦（单一职责）；SKILL.md 正文少于 500 行；参考文件距 SKILL.md 仅一层。

输出消息

创建技能时告知用户：

✅ 技能创建成功
📁 位置：.agent/skills/[name]/SKILL.md
🎯 用途：[简要描述]
🔧 如何测试：[应触发该技能的示例提示]
💡 提示：当检测到 [上下文] 时，智能体将自动使用此技能。

限制

资料未提供 Skill Creator 的具体收费、价格、支持平台等信息。具体可用性以产品官方说明为准。