skill-creator

技能创建器

概述

创建有效的技能，通过专业知识、工作流和工具扩展 Claude 的能力。技能是模块化的软件包，可将 Claude 从通用 Agent 转变为具备特定领域程序性知识的专业 Agent。

此技能以身作则，通过渐进式披露精简入口，同时在参考文件中提供详尽内容。

何时使用此技能

在以下情况启用：

• 从头创建新技能
• 更新或重构现有技能
• 为单体技能添加渐进式披露
• 了解技能结构和最佳实践
• 规划技能组件（脚本、参考资料、资源）
• 打包技能以供分发

核心原则

1. 示例驱动设计：从具体使用示例入手，而非抽象概念
2. 渐进式披露：将入口保持在 <200 行（最佳：140-160 行），详细内容放在参考资料中
3. 可复用组件：将重复使用的代码提取为脚本，将知识提取为参考资料，将模板提取为资源
4. 祈使语气：始终使用动词开头的指令（而非第二人称）
5. 专用资源：每个组件都应解决特定的重复性需求

技能提供的内容

四项核心能力：

1. 专业工作流 - 面向特定领域的多步骤流程
2. 工具集成 - 使用文件格式或 API 的说明
3. 领域专业知识 - 公司专属知识、架构和业务逻辑
4. 捆绑资源 - 用于复杂任务的脚本、参考资料和资源

三级加载系统：

1. 元数据（名称 + 描述）- 始终处于上下文中（约 100 个词）
2. SKILL.md 正文 - 仅在技能触发时加载（<200 行，最佳：140-160 行）
3. 捆绑资源 - Claude 按需加载（数量不限）

快速入门

六步创建流程

步骤 1：通过具体示例理解需求 收集 3-5 个真实的使用示例。询问：“用户会说什么来触发此技能？”以及“它应该完成哪些任务？” → 完整指南

步骤 2：规划可复用组件 分析示例，确定需要哪些脚本（重复使用的代码）、参考资料（领域知识）和资源（模板）。→ 规划指南

步骤 3：初始化技能 运行 scripts/init_skill.py <skill-name> --path <output-directory> 以生成模板结构。→ 初始化详情

步骤 4：编辑技能 实现脚本/参考资料/资源，然后使用祈使语气更新 SKILL.md。如果超过 150 行，则应用渐进式披露。→ 编辑指南

步骤 5：打包并验证 运行 scripts/package_skill.py <path/to/skill-folder> 以验证并创建可分发的 zip 文件。→ 打包指南

步骤 6：迭代 在实际任务中使用，留意遇到的困难，并据此更新技能。→ 迭代指南

技能结构

skill-name/
├── SKILL.md (required)           # Entry point with frontmatter + markdown
├── scripts/ (optional)           # Executable code (Python/Bash)
├── references/ (optional)        # Documentation loaded as needed
└── assets/ (optional)            # Templates, images, files for output

组件指南：

• 脚本：在同一段代码需要反复重写或需要确定性执行时使用
• 参考资料：用于详细规范、工作流、架构和 API 文档（每份 150-500 行）
• 资源：用于输出中使用的模板、样板代码、图像和字体
• 入口：核心工作流、导航和提醒（最佳长度为 140-160 行）

→ 完整结构指南

渐进式披露模式

适用场景： 技能总计超过 150 行

实现方式：

1. 添加 progressive_disclosure 前置元数据，包含 summary、when_to_use、quick_start
2. 将入口精简至 140-160 行（核心工作流 + 导航）
3. 创建 3-5 个参考文件（每个 150-500 行）
4. 按主题组织：结构、工作流、最佳实践、示例
5. 添加导航部分，链接到所有参考文件

优点：

• 入口只加载必要内容
• 需要时可查阅详细信息
• 组织更合理，也更易于维护
• 入口篇幅减少 20-30%

→ 完整的渐进式披露指南

元示例： 此 skill-creator 展示了渐进式披露：

• 入口：150 行（比原来的 209 行减少 28%）
• 参考文件：5 个文件，包含完整的实现细节
• 最近优化的项目：mcp-builder（160 行）、testing-anti-patterns（140 行）

导航

核心概念

• 🏗️ 技能结构 - 剖析结构、组件（脚本/参考文件/资源）、渐进式披露架构。规划技能布局或了解资源类型时加载。

分步流程

• 🔄 创建工作流 - 从示例到迭代的完整 6 步流程。创建新技能或遵循结构化工作流时加载。

设计模式

• 📊 渐进式披露 - 三级加载、实现指南、反模式、示例。重构超过 150 行的技能或优化上下文用量时加载。

质量标准

• ✅ 最佳实践 - 写作风格、元数据质量、内容组织、反模式。编写/审查技能内容或确保质量时加载。

实际示例

• 📚 示例 - 完整的技能示例：mcp-builder、testing-anti-patterns、pdf-editor、brand-guidelines、database-builder、frontend-builder。开始创建新技能或寻找模式时加载。

重要提醒

• 从示例入手 - 设计前先准备 3-5 个具体使用场景
• 使用初始化脚本 - scripts/init_skill.py 会自动创建合适的结构
• 使用祈使语气 - “要完成 X，请执行 Y”（而不是“应该执行 X”）
• 渐进式披露 - 入口少于 200 行，详细内容放在参考文件中（适用于超过 150 行的技能）
• 避免重复 - 信息只在一个位置维护（入口摘要、参考文件详情）
• 明确组件用途 - 脚本用于代码，参考文件用于知识，资源用于模板
• 分享前先验证 - scripts/package_skill.py 会验证并打包
• 持续迭代 - 在实际任务中使用，并根据遇到的问题更新

危险信号 - 停止

遇到以下情况时请停止：

• “我把所有细节都写进 SKILL.md” → 移至参考文件（渐进式披露）
• “我会使用第二人称” → 改用祈使语气
• “入口和参考文件里有相同信息” → 删除重复内容
• 使用泛泛的描述 → 明确具体的激活条件
• 保留初始化脚本生成的示例文件 → 删除未使用的资源
• 跳过验证 → 分享前务必运行 package_skill.py
• 创建技能时没有示例 → 先收集具体使用场景
• 入口超过 200 行 → 应用渐进式披露模式

以上任何一项都意味着：停止。检查原则和参考文件。

与其他技能的集成

元技能：

• skill-creator（本技能）- 创建其他技能，并展示自身采用的模式

开发技能：

• mcp-builder - 渐进式披露实现示例
• testing-anti-patterns - 超精简入口示例（140 行）

工作流技能：

• documentation - 编写清晰、有条理的内容
• verification-before-completion - 打包前测试技能

实际影响

根据技能优化经验：

• 渐进式披露：入口内容长度减少 20-30%
• mcp-builder：209 → 160 行（减少 23%，含 6 个参考文档）
• testing-anti-patterns：→ 140 行（超精简，含 4 个参考文档）
• skill-creator：209 → 150 行（减少 28%，含 5 个参考文档）
• 上下文效率：仅加载所需参考文档（节省 50-80% 的上下文）
• 可维护性：更新特定参考文档，无需改动入口内容
• 清晰度：更好的组织方式提升了内容的可发现性和易懂性

---

请记住： 技能是可将 Claude 转变为专用 Agent 的模块化套件。对于超过 150 行的技能，请采用渐进式披露。本技能展示了它所教授的模式。