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

skill-creator

智能体与模型

查看项目

更新于 10-16 13:12

技能介绍

用途

skill-creator 是一个用于指导创建有效技能的技能。当用户希望创建新技能（或更新现有技能）以扩展 Claude 的能力时，应使用此技能。技能是模块化的自包含包，通过提供专业知识、工作流和工具来扩展 Claude 的能力，可将 Claude 从通用代理转变为具备程序性知识的专业代理。

技能提供的内容

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

核心原则

简洁是关键

上下文窗口是公共资源。技能与 Claude 所需的其他一切共享上下文窗口。默认假设：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（必需）

  • Frontmatter（YAML）：包含 name 和 description 字段。这是 Claude 用来确定技能何时被使用的唯一字段，因此清晰全面地描述技能是什么以及何时使用非常重要。
  • 正文（Markdown）：使用技能的说明和指导。仅在技能触发后加载。

捆绑资源（可选）

  • Scripts（scripts/）：可执行代码（Python/Bash 等），用于需要确定性可靠性或反复重写的任务。示例：scripts/rotate_pdf.py。优点：节省 token、确定性、可在不加载到上下文的情况下执行。
  • References（references/）：旨在按需加载到上下文中的文档和参考资料。示例：references/finance.md、references/mnda.md、references/policies.md、references/api_docs.md。用途：数据库模式、API 文档、领域知识、公司政策、详细工作流指南。最佳实践：如果文件较大（超过 1 万词），在 SKILL.md 中包含 grep 搜索模式。避免重复。
  • Assets（assets/）：不打算加载到上下文中，而是在 Claude 产生的输出中使用的文件。示例：assets/logo.png、assets/slides.pptx、assets/frontend-template/、assets/font.ttf。

技能中不应包含的内容

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

渐进式披露设计原则

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

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

模式 1：带参考的高层指南

# PDF Processing

## Quick start

Extract text with pdfplumber:
[code example]

## Advanced features

- **Form filling**: See [FORMS.md](FORMS.md) for complete guide
- **API reference**: See [REFERENCE.md](REFERENCE.md) for all methods
- **Examples**: See [EXAMPLES.md](EXAMPLES.md) for common patterns

模式 2：领域特定组织

bigquery-skill/
├── SKILL.md (overview and navigation)
└── reference/
    ├── finance.md (revenue, billing metrics)
    ├── sales.md (opportunities, pipeline)
    ├── product.md (API usage, features)
    └── marketing.md (campaigns, attribution)

类似地，支持多个框架或变体的技能按变体组织：

cloud-deploy/
├── SKILL.md (workflow + provider selection)
└── references/
    ├── aws.md (AWS deployment patterns)
    ├── gcp.md (GCP deployment patterns)
    └── azure.md (Azure deployment patterns)

模式 3：条件细节

# DOCX Processing

## Creating documents

Use docx-js for new documents. See [DOCX-JS.md](DOCX-JS.md).

## Editing documents

For simple edits, modify the XML directly.

**For tracked changes**: See [REDLINING.md](REDLINING.md)
**For OOXML details**: See [OOXML.md](OOXML.md)

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

技能创建流程

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

清晰地理解技能将如何被使用的具体示例。示例问题包括：技能应支持哪些功能？能否举例说明如何使用？用户会说什么来触发此技能？避免在单条消息中问太多问题。

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

通过分析每个示例，确定包含哪些脚本、参考和资产。例如 PDF 旋转需要 scripts/rotate_pdf.py，前端应用需要 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：编辑技能

参考设计模式指南：多步骤流程参见 references/workflows.md，特定输出格式或质量标准参见 references/output-patterns.md。从可复用技能内容开始实施。添加的脚本必须实际运行测试。删除不需要的示例文件。

编写指南：始终使用祈使/不定式形式。

Frontmatter 中 description 示例："Comprehensive document creation, editing, and analysis with support for tracked changes, comments, formatting preservation, and text extraction. Use when Claude needs to work with professional documents (.docx files) for: (1) Creating new documents, (2) Modifying or editing content, (3) Working with tracked changes, (4) Adding comments, or any other document tasks"

不要在 YAML frontmatter 中包含任何其他字段。

步骤 5：打包技能

开发完成后，打包为可分发的 .skill 文件：

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

可选输出目录：

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

打包脚本会自动验证技能，检查 YAML frontmatter 格式和必填字段、技能命名约定和目录结构等。

适用场景

  • 创建新技能以扩展 Claude 能力
  • 更新现有技能
  • 为特定领域或任务构建程序性知识
  • 打包和分发技能

限制

官方资料未提供关于收费、价格、平台要求或具体运行环境的更多信息。