SuperAPI AI 工具集

create-skill

智能体与模型

查看项目

更新于 10-16 05:35

技能介绍

用途

create-skill 用于创建一个新的技能(Skill),以专门的知识、工作流或工具集成来扩展 Claude 的能力。该技能仅在输入 /create-skill 时触发。

核心原则

简洁是关键。上下文窗口是共享资源,只应添加 Claude 本身不具备的上下文。对每一部分内容都应质疑:“Claude 真的需要这个吗?”

技能的结构

一个技能由以下部分组成:

skill-name/
├── SKILL.md (required)
│   ├── YAML frontmatter (name, description)
│   └── Markdown instructions
└── Bundled Resources (optional)
    ├── scripts/      - Executable code
    ├── references/   - Documentation
    └── assets/       - Templates, images

其中 SKILL.md 为必需项,包含 YAML frontmatter(name、description)和 Markdown 指令;捆绑资源为可选项,包括 scripts/(可执行代码)、references/(文档)、assets/(模板、图片)。

SKILL.md 格式

---
name: my-skill-name
description: A clear description of what this skill does and when to use it
---

# My Skill Name

[Instructions for Claude when this skill is active]

## Examples
- Example usage 1
- Example usage 2

## Guidelines
- Guideline 1
- Guideline 2

技能创建流程

第 1 步:通过示例理解

收集该技能将被如何使用具体示例。询问:

  • “这个技能应该支持什么功能?”
  • “用户会说什么话来触发这个技能?”

第 2 步:规划可复用内容

分析示例以识别:

  • Scripts:会被反复重写的代码
  • References:Claude 需要参考的文档
  • Assets:用于输出的模板、图片

第 3 步:初始化

创建技能目录结构,包含 SKILL.md 和资源文件夹。

位置:skills/[skill-name]/SKILL.md

第 4 步:实现

  • 从可复用资源(scripts、references、assets)开始
  • 编写带有正确 frontmatter 的清晰 SKILL.md
  • 通过实际运行来测试脚本

第 5 步:迭代

在真实任务中使用该技能,注意遇到的困难,并加以改进。

渐进式披露

保持 SKILL.md 在 500 行以内。拆分内容,例如:

# PDF Processing

## Quick start
[code example]

## Advanced features
- **Form filling**: See [FORMS.md](FORMS.md)
- **API reference**: See [REFERENCE.md](REFERENCE.md)

不应包含的内容

  • README.md
  • INSTALLATION_GUIDE.md
  • CHANGELOG.md
  • 面向用户的文档

技能是给 AI 智能体使用的,不是给人类使用的。

Frontmatter 选项

---
name: skill-name           # Required: identifier
description: When to use   # Required: triggers skill discovery
references:                # Optional: files to load progressively
  - references/api.md
  - references/examples.md
allowed-tools:             # Optional: restrict tool access
  - Bash(git:*)
  - Read
  - Write
---

其中 name 为必填(标识符),description 为必填(触发技能发现),references 为可选(渐进式加载的文件),allowed-tools 为可选(限制工具访问)。

适用场景

适用于需要为 Claude 创建新技能、扩展其专门知识、工作流或工具集成能力的场景。

限制

该技能仅在输入 /create-skill 时触发。关于收费、价格、平台支持范围等信息,资料中暂未提供。