⚡

技能创建器Skill skill-creator

此技能提供创建高效AI代理技能的指南，帮助用户扩展AI代理能力，包括专业知识、工作流程和工具集成。适用于支持SKILL.md格式的任何代理，如Claude Code、Cursor等。触发于特定短语如“创建技能”。关键词：AI技能创建，智能体技能，工作流程集成，工具扩展，AI代理开发。

AI智能体 0 次安装 0 次浏览 更新于 3/15/2026

name: skill-creator description: 用于创建有效AI代理技能的指南。当用户想要创建新技能（或更新现有技能），以通过专业知识、工作流程或工具集成来扩展AI代理能力时使用。适用于支持SKILL.md格式的任何代理（如Claude Code、Cursor、Roo、Cline、Windsurf等）。触发于“create skill”、“new skill”、“package knowledge”、“skill for”。

技能创建器

此技能提供创建高效、与代理无关的技能的指导。

关于技能

技能是模块化、自包含的包，通过提供专业知识、工作流程和工具来扩展AI代理能力。可将它们视为特定领域或任务的“入门指南”，将通用代理转变为具备程序性知识的专用代理。

技能提供的功能

  1. 专用工作流程 - 针对特定领域的多步骤程序
  2. 工具集成 - 用于处理特定文件格式或API的说明
  3. 领域专业知识 - 公司特定知识、模式、业务逻辑
  4. 捆绑资源 - 用于复杂和重复任务的脚本、参考资料和资产

核心原则

简洁是关键

上下文窗口是一种公共资源。技能与代理所需的一切共享上下文。

默认假设：代理已经非常智能。 仅添加它尚未拥有的上下文。质疑每条信息：“代理真的需要这个吗？”和“这段文字是否值得其代币成本？”

偏好简洁示例而非冗长解释。

技能的解剖结构

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

技能名称/
├── SKILL.md（必需）
│   ├── YAML前置元数据（必需）
│   │   ├── name:（必需）
│   │   └── description:（必需）
│   └── Markdown说明（必需）
└── 捆绑资源（可选）
    ├── scripts/          - 可执行代码（Python/Bash等）
    ├── references/       - 需要时加载到上下文中的文档
    └── assets/           - 用于输出的文件（模板、图标、字体等）

SKILL.md（必需）

每个SKILL.md包含：

  • 前置元数据（YAML）：包含name和description字段。这些是确定技能何时被使用的唯一字段，请清晰全面。
  • 正文（Markdown）：使用技能的说明和指导。仅在技能触发后加载。

捆绑资源（可选）

脚本（scripts/）

用于需要确定性可靠性或重复重写的任务的可执行代码。

  • 何时包含：当相同代码被重复重写时
  • 示例：用于PDF旋转任务的scripts/rotate_pdf.py
  • 好处：代币高效、确定性
参考资料（references/）

工作时需要参考的文档和参考资料。

  • 何时包含：用于代理工作时应参考的文档
  • 示例：用于数据库模式的references/schema.md，用于API规范的references/api_docs.md
  • 好处：保持SKILL.md精简，仅在需要时加载
资产（assets/）

不打算加载到上下文中，但用于输出的文件。

  • 何时包含：当技能需要文件用于最终输出时
  • 示例：用于品牌资产的assets/logo.png，用于HTML样板的assets/template.html

渐进式披露

技能使用三级加载系统：

  1. 元数据（name + description） - 始终在上下文中（约100字）
  2. SKILL.md正文 - 当技能触发时（<5k字）
  3. 捆绑资源 - 根据需要（无限制）

保持SKILL.md正文少于500行。接近此限制时，将内容拆分到单独文件中。

技能创建过程

步骤1：理解技能

用具体示例澄清：

  • “此技能应支持什么功能？”
  • “你能举例说明此技能将如何被使用吗？”
  • “什么会触发此技能？”

步骤2：规划可重用内容

分析每个示例：

  1. 考虑如何从零开始执行
  2. 识别有用的脚本、参考资料和资产

步骤3：创建技能

创建技能目录：

技能名称/
├── SKILL.md
├── scripts/     （如需要）
├── references/  （如需要）
└── assets/      （如需要）

步骤4：编写SKILL.md

前置元数据

---
name: 技能名称
description: 技能的作用和使用时机。包括特定触发和上下文。最大1024字符。
---

描述指南：

  • 包括技能的作用和使用时机
  • 包括触发短语
  • 最大1024字符，无XML标签
  • 用第三人称编写

正文

编写使用技能的说明。包括：

  • 快速入门指南
  • 分步工作流程
  • 需要时链接到参考文件

步骤5：测试和迭代

  1. 在真实任务上使用技能
  2. 注意困难或低效之处
  3. 相应更新SKILL.md或资源
  4. 再次测试

质量检查清单

定稿前：

  • [ ] 描述具体说明使用时机（最大1024字符）
  • [ ] 文件夹名称使用kebab-case
  • [ ] 说明是可操作且无歧义的
  • [ ] 范围专注（单一职责）
  • [ ] SKILL.md正文少于500行
  • [ ] 参考资料从SKILL.md一级深入

输出消息

创建技能时，通知用户：

✅ 技能创建成功！

📁 位置：.agent/skills/[名称]/SKILL.md
🎯 目的：[简要描述]
🔧 如何测试：[应触发技能的示例提示]

💡 提示：代理在检测到[上下文]时将自动使用此技能。