skill-creator

技能创建器

技能是模块化软件包，通过提供专业知识、工作流和工具来扩展 Claude 的能力。

核心原则

简洁至上

上下文窗口是一项共享资源。只添加 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 格式

---
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 步：规划可复用内容

分析示例，确定以下内容：

• 脚本：需要反复重写的代码
• 参考资料：Claude 需要查阅的文档
• 资源：用于输出的模板、图片

第 3 步：初始化

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

第 4 步：实现

• 从可复用资源（脚本、参考资料、资源）入手
• 编写清晰的 SKILL.md，并使用正确的 frontmatter
• 实际运行脚本进行测试

第 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 Agent 创建的，而不是为人创建的。