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

skill_creator

智能体与模型

查看项目

更新于 10-16 02:05

技能介绍

用途

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

技能能提供什么

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

核心原则

简洁是关键：上下文窗口是公共资源，技能与系统提示、对话历史、其他技能元数据及用户请求共享上下文窗口。默认假设 Claude 已经很聪明，只添加 Claude 尚不具备的上下文。优先使用简洁示例而非冗长解释。

设置适当的自由度：根据任务的脆弱性和可变性匹配具体程度。高自由度（基于文本的指令）适用于多种方法有效、决策依赖上下文的情况；中自由度（伪代码或带参数的脚本）适用于存在首选模式、允许一定变化的情况；低自由度（特定脚本、少量参数）适用于操作脆弱易错、一致性关键或必须遵循特定顺序的情况。

技能的结构

每个技能包含一个必需的 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 判断技能何时被使用的唯一字段）和 Markdown 正文（仅在技能触发后加载）。

Scripts（scripts/）：可执行代码，用于需要确定性可靠性或反复重写的任务。例如 scripts/rotate_pdf.py 用于 PDF 旋转任务。优点是令牌高效、确定性、可无需加载到上下文即可执行。

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

Assets（assets/）：不加载到上下文，而是在 Claude 输出中使用的文件。例如品牌资产、PowerPoint 模板、HTML/React 样板、字体。

不应包含的内容

技能应只包含直接支持其功能的必要文件。不要创建无关文档或辅助文件，包括 README.md、INSTALLATION_GUIDE.md、QUICK_REFERENCE.md、CHANGELOG.md 等。

渐进式披露设计原则

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

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

模式 1：带参考的高级指南：SKILL.md 包含快速开始和高级功能链接，Claude 仅在需要时加载参考文件。

模式 2：领域特定组织：按领域组织内容以避免加载无关上下文，如 bigquery-skill 按 finance.md、sales.md、product.md、marketing.md 组织。

模式 3：条件细节：显示基本内容，链接到高级内容。

重要指南：避免深层嵌套引用，保持引用距 SKILL.md 一层深度；对于超过 100 行的参考文件，在顶部包含目录。

技能创建流程

  1. 用具体示例理解技能：明确技能将如何被使用的具体示例，可通过用户示例或生成示例并验证。
  2. 规划可复用技能内容：分析每个示例，识别重复执行时哪些脚本、参考资料和资产会有帮助。
  3. 初始化技能：运行 scripts/init_skill.py <skill-name> --path <output-directory>，生成包含 SKILL.md 模板和示例资源目录的模板。
  4. 编辑技能：从可复用资源开始实现，测试添加的脚本，更新 SKILL.md。Frontmatter 只包含 name 和 description，description 是主要触发机制，应包含技能做什么以及何时使用的具体触发条件。正文使用祈使/不定式形式。
  5. 打包技能：运行 scripts/package_skill.py <path/to/skill-folder>，自动验证技能并打包为可分发的 .skill 文件。可选指定输出目录：scripts/package_skill.py <path/to/skill-folder> ./dist。
  6. 基于实际使用迭代。

适用场景

适用于需要为 Claude 创建新技能或更新现有技能的场景，特别是当用户希望扩展 Claude 在特定领域的能力、集成特定工具或文件格式、封装公司特定知识或工作流时。

限制

资料中未提供关于收费、价格、平台支持范围、具体效果或使用步骤的更多信息。