技能创建器
本技能提供创建高效 Claude 技能的指导，适用于用户想要创建新技能或更新现有技能，以扩展 Claude 的能力（包括专业知识、工作流程或工具集成）的场景。
关于技能
技能是模块化、自包含的软件包，通过提供专业知识、工作流程和工具来扩展 Claude 的能力。可以将它们视为特定领域或任务的“入职指南”，把 Claude 从通用代理转变为配备程序性知识的专业代理。
技能可提供：专业工作流程（特定领域的多步骤流程）、工具集成（处理特定文件格式或 API 的说明）、领域专业知识（公司特定知识、模式、业务逻辑）、捆绑资源（用于复杂和重复任务的脚本、参考资料和资产）。
核心原则
简洁是关键：上下文窗口是公共资源，技能与系统提示、对话历史、其他技能元数据及用户请求共享它。默认假设 Claude 已经非常智能，只添加其尚未具备的上下文，优先使用简洁示例而非冗长解释。
设置适当的自由度：根据任务脆弱性和可变性匹配具体程度。高自由度（基于文本的指令）适用于多种方法有效、决策依赖上下文或启发式指导的情况；中等自由度（伪代码或带参数的脚本）适用于存在首选模式、可接受变化或配置影响行为的情况；低自由度（特定脚本、少量参数）适用于操作脆弱易错、一致性至关重要或必须遵循特定顺序的情况。
技能的结构
每个技能由一个必需的 SKILL.md 文件和可选的捆绑资源组成，目录结构如下：
skill-name/ ├── SKILL.md（必需） │ ├── YAML 前置元数据（必需） │ │ ├── name:（必需） │ │ └── description:（必需） │ └── Markdown 说明（必需） └── 捆绑资源（可选） ├── scripts/ - 可执行代码（Python/Bash 等） ├── references/ - 根据需要加载到上下文中的文档 └── assets/ - 用于输出的文件（模板、图标、字体等）
SKILL.md（必需）：包含 YAML 前置元数据（name 和 description）及 Markdown 正文。描述字段是 Claude 确定何时使用该技能的唯一字段，因此需清晰全面说明技能是什么及何时使用。正文仅在技能触发后加载。
脚本（scripts/）：用于需要确定性可靠性或重复编写的任务，如 scripts/rotate_pdf.py。优点是 token 高效、确定性强、可无需加载到上下文执行；但脚本可能仍需 Claude 读取以进行修补或环境调整。
参考资料（references/）：用于根据需要加载到上下文以指导 Claude 的文档，如 references/finance.md、references/mnda.md、references/policies.md、references/api_docs.md。适用于数据库模式、API 文档、领域知识、公司政策、详细工作流程指南。最好保持 SKILL.md 精简，若文件较大（大于 10k 字），在 SKILL.md 中包含 grep 搜索模式。避免重复：信息应仅存在于 SKILL.md 或参考文件中，而非两者。
资产（assets/）：不打算加载到上下文，而是在输出中使用的文件，如 assets/logo.png、assets/slides.pptx、assets/frontend-template/、assets/font.ttf。用于模板、图像、图标、样板代码、字体、被复制或修改的示例文档。
技能中不应包含的内容：仅包含直接支持功能的必要文件，不要创建 README.md、INSTALLATION_GUIDE.md、QUICK_REFERENCE.md、CHANGELOG.md 等多余文档或辅助文件。
渐进式披露设计原则
技能使用三级加载系统：元数据（名称+描述）始终在上下文中（约 100 字）；SKILL.md 正文在技能触发时加载（小于 5k 字）；捆绑资源根据 Claude 需要加载（无限制，因为脚本可无需读入上下文执行）。
保持 SKILL.md 正文精简，不超过 500 行。当接近此限制时，将内容拆分到单独文件，并从 SKILL.md 引用并清楚描述何时读取。
模式 1：带参考资料的高级指南。在 SKILL.md 中保留快速入门和高级功能链接，Claude 仅在需要时加载 FORMS.md、REFERENCE.md 或 EXAMPLES.md。
模式 2：领域特定组织。如 bigquery-skill 按 finance.md、sales.md、product.md、marketing.md 组织；多框架技能如 cloud-deploy 按 aws.md、gcp.md、azure.md 组织，仅在选中时读取对应文件。
模式 3：条件详情。显示基本内容并链接高级内容，如 DOCX 处理中，修订追踪参见 REDLINING.md，OOXML 详情参见 OOXML.md。
重要指南：避免深层嵌套引用，保持从 SKILL.md 起一层深度；结构化较长参考文件，超过 100 行时在顶部包含目录。
技能创建流程
步骤 1：通过具体示例理解技能。收集技能如何使用的具体示例，例如图像编辑器技能应支持哪些功能、使用示例、触发语句等。避免单条消息问太多问题。当对功能有清晰认识时结束此步骤。
步骤 2：规划可重用的技能内容。分析每个示例，确定哪些脚本、参考资料和资产有帮助。例如旋转 PDF 可存储 scripts/rotate_pdf.py；前端应用可存储样板 assets/hello-world/；BigQuery 可存储 references/schema.md。
步骤 3：初始化技能。从头创建新技能时运行 scripts/init_skill.py <技能名称> --path <输出目录>。该脚本创建技能目录、生成带前置元数据和 TODO 占位符的 SKILL.md 模板、创建 scripts/、references/、assets/ 示例资源目录及示例文件。
步骤 4：编辑技能。从可重用资源开始实现，添加的脚本必须实际运行测试。删除不需要的示例文件和目录。更新 SKILL.md：始终使用祈使句/不定式形式。编写 YAML 前置元数据，name 为技能名称，description 包含技能做什么及使用触发器/上下文，所有“何时使用”信息放在此处而非正文。不要包含其他字段。
步骤 5：打包技能。运行 scripts/package_skill.py <技能文件夹路径>，可选输出目录如 ./dist。打包脚本先验证 YAML 前置元数据格式和必需字段、命名约定和目录结构、描述完整性和质量、文件组织和资源引用；验证通过后创建以技能命名的 .skill 文件（扩展名为 .skill 的 zip 文件）；验证失败则报告错误并退出，修复后重新运行。
步骤 6：迭代。在实际任务中使用技能，注意困难或低效之处，确定应如何更新 SKILL.md 或捆绑资源，实施更改并再次测试。