SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场skill-creator

skill-creator

智能体与模型

查看项目

更新于 10-15 16:57

技能介绍

用途

Skill Creator 是一个指导型技能，用于帮助用户创建有效的新技能，或更新现有技能，从而扩展 Claude 的能力。技能是模块化、自包含的包，为 Claude 提供专门的知识、工作流和工具，可将其从通用智能体转变为特定领域的专用智能体。

技能能提供什么

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

技能的解剖结构

每个技能包含一个必需的 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 intended to be loaded into context as needed
    └── assets/           - Files used in output (templates, icons, fonts, etc.)

SKILL.md（必需）

YAML frontmatter 中的 name 和 description 决定 Claude 何时使用该技能。应具体说明技能做什么以及何时使用，并使用第三人称（例如 "This skill should be used when..."）。

捆绑资源（可选）

Scripts（scripts/）：可执行代码（Python/Bash 等），用于需要确定性可靠性或反复重写的任务。示例：scripts/rotate_pdf.py 用于 PDF 旋转任务。优点：节省 token、确定性、可无需加载到上下文即可执行。

References（references/）：按需加载到上下文以指导 Claude 过程的文档和参考资料。示例：references/finance.md 用于财务模式，references/api_docs.md 用于 API 规范。最佳实践：如果文件很大（超过 1 万词），在 SKILL.md 中包含 grep 搜索模式。避免重复：信息应只存在于 SKILL.md 或 references 文件之一。

Assets（assets/）：不加载到上下文，而是在 Claude 输出中使用的文件。示例：assets/logo.png 用于品牌资产，assets/slides.pptx 用于 PowerPoint 模板，assets/frontend-template/ 用于 HTML/React 样板。

渐进式披露设计原则

技能使用三级加载系统来高效管理上下文：

  1. 元数据（name + description）——始终在上下文中（约 100 词）
  2. SKILL.md 正文——技能触发时加载（少于 5000 词）
  3. 捆绑资源——按 Claude 需要加载（无限制，因为脚本可执行而无需读入上下文窗口）

技能创建流程

步骤 1：通过具体示例理解技能

清晰理解技能将如何被使用的具体示例。可通过直接用户示例或经用户反馈验证的生成示例获得。例如构建图像编辑器技能时，可询问：该技能应支持哪些功能？能否给出使用示例？用户会说什么来触发该技能？避免在单条消息中问太多问题。

步骤 2：规划可复用的技能内容

分析每个示例：从头执行该示例需要什么？反复执行这些工作流时哪些脚本、参考资料和资产会有帮助？例如 PDF 旋转需要反复重写相同代码，可存储 scripts/rotate_pdf.py；前端 Web 应用需要相同的 HTML/React 样板，可存储 assets/hello-world/ 模板；BigQuery 查询需要反复发现表模式，可存储 references/schema.md。

步骤 3：初始化技能

从头创建新技能时，始终运行 init_skill.py 脚本：

scripts/init_skill.py <skill-name> --path <output-directory>

该脚本会：在指定路径创建技能目录；生成带正确 frontmatter 和 TODO 占位符的 SKILL.md 模板；创建示例资源目录 scripts/、references/ 和 assets/；在每个目录中添加可自定义或删除的示例文件。

步骤 4：编辑技能

技能是为另一个 Claude 实例使用而创建的。从可复用技能内容开始：scripts/、references/ 和 assets/ 文件。删除不需要的示例文件和目录。

更新 SKILL.md 时，使用祈使/不定式形式（动词开头的指令），而非第二人称。使用客观的指导性语言（例如 "To accomplish X, do Y" 而非 "You should do X"）。需回答：技能的目的是什么？何时应使用该技能？Claude 在实践中应如何使用该技能？

步骤 5：打包技能

技能准备就绪后，打包为可分发的 zip 文件：

scripts/package_skill.py <path/to/skill-folder>

可选指定输出目录：

scripts/package_skill.py <path/to/skill-folder> ./dist

打包脚本会自动验证：YAML frontmatter 格式和必填字段；技能命名约定和目录结构；描述完整性和质量；文件组织和资源引用。验证通过后创建以技能命名的 zip 文件（如 my-skill.zip）。验证失败则报告错误并退出，修复后重新运行。

步骤 6：迭代

在真实任务中使用技能，注意困难或低效之处，确定 SKILL.md 或捆绑资源应如何更新，实施更改并再次测试。

参考文件

  • references/AGENT_SKILL.template.md - 技能 YAML frontmatter 和正文结构模板
  • references/SUBAGENT.template.md - 子智能体配置模板，含 frontmatter 字段和说明

适用场景

适用于用户希望创建新技能或更新现有技能以扩展 Claude 能力的场景，尤其是需要将特定领域的工作流、工具集成、领域专业知识或可复用资源封装为模块化技能时。

限制

资料未提供该技能的具体收费、价格、平台支持范围或效果保证等信息。