用途
Skill Creator 用于指导创建有效的技能(Skill)。当用户想要创建新技能,或更新现有技能以扩展 Claude 的能力时,应使用该技能。技能是模块化、自包含的包,通过提供专门的知识、工作流和工具来扩展 Claude 的能力,可将其视为特定领域或任务的“入门指南”,把 Claude 从通用智能体转变为具备程序性知识的专用智能体。
技能提供的内容
- 专门的工作流:针对特定领域的多步骤流程
- 工具集成:处理特定文件格式或 API 的说明
- 领域专业知识:公司特定知识、模式、业务逻辑
- 捆绑资源:用于复杂和重复任务的脚本、参考资料和资产
核心原则
简洁是关键:上下文窗口是公共资源,技能与系统提示、对话历史、其他技能元数据及用户请求共享上下文窗口。默认假设 Claude 已经非常聪明,只添加 Claude 尚不具备的上下文。对每条信息都要质疑:“Claude 真的需要这个解释吗?”“这段文字值得它的 token 成本吗?”优先使用简洁示例而非冗长解释。
设置适当的自由度:将具体程度与任务的脆弱性和可变性相匹配。高自由度(基于文本的指令)适用于多种方法有效、决策依赖上下文或启发式引导的场景;中自由度(伪代码或带参数的脚本)适用于存在首选模式、允许一定变化或配置影响行为的场景;低自由度(特定脚本、少量参数)适用于操作脆弱易错、一致性至关重要或必须遵循特定顺序的场景。
技能的结构
每个技能由必需的 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。优势:token 高效、确定性、可无需加载到上下文即可执行。
References(references/):按需加载到上下文中的文档和参考资料。示例:references/finance.md、references/api_docs.md。用途:数据库模式、API 文档、领域知识、公司政策、详细工作流指南。最佳实践:如果文件较大(超过 1 万词),在 SKILL.md 中包含 grep 搜索模式。避免重复:信息应只存在于 SKILL.md 或 references 文件之一。
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 等。
渐进式披露设计原则
技能使用三级加载系统来高效管理上下文:
- 元数据(name + description)——始终在上下文中(约 100 词)
- SKILL.md 正文——技能触发时加载(少于 5000 词)
- 捆绑资源——Claude 按需加载(无限,因为脚本可执行而无需读入上下文窗口)
渐进式披露模式:
- 模式 1:带参考的高级指南——SKILL.md 中保留核心工作流,将变体细节移入单独的参考文件
- 模式 2:按领域组织——对于多领域技能,按领域组织内容以避免加载无关上下文
- 模式 3:条件细节——展示基础内容,链接到高级内容
重要准则:避免深层嵌套引用,保持引用距 SKILL.md 一层深度;对于超过 100 行的参考文件,在顶部包含目录。
技能创建流程
- 用具体示例理解技能:明确技能将如何被使用的具体示例,可通过用户示例或生成示例并经用户反馈验证。
- 规划可复用的技能内容:分析每个示例,识别重复执行这些工作流时有帮助的脚本、参考资料和资产。
- 初始化技能:从头创建新技能时,始终运行 init_skill.py 脚本。用法:
scripts/init_skill.py <skill-name> --path <output-directory>。该脚本创建技能目录、生成带 frontmatter 和 TODO 占位符的 SKILL.md 模板、创建示例资源目录并添加示例文件。 - 编辑技能:为另一个 Claude 实例使用而创建。参考设计模式指南:多步骤流程参见 references/workflows.md,特定输出格式或质量标准参见 references/output-patterns.md。从可复用资源开始实现,添加的脚本必须实际运行测试。更新 SKILL.md 时始终使用祈使/不定式形式。frontmatter 中只写 name 和 description,description 是主要触发机制,应包含技能做什么以及何时使用的具体触发条件。
- 打包技能:开发完成后打包为可分发的 .skill 文件。用法:
scripts/package_skill.py <path/to/skill-folder>,可选指定输出目录:scripts/package_skill.py <path/to/skill-folder> ./dist。打包脚本会自动验证 YAML frontmatter 格式和必需字段、技能命名约定和目录结构等。 - 基于实际使用迭代。
适用场景
适用于需要为 Claude 创建新技能或更新现有技能的场景,包括构建特定领域工作流、工具集成、领域专业知识封装以及捆绑脚本、参考资料和资产等。
限制
资料中未提供该技能的具体收费、价格、平台支持范围等信息。