name: 技能创建器 description: 创建有效技能的指南。该技能应在用户想要创建新技能（或更新现有技能）时使用，这些技能通过专业知识、工作流或工具集成来扩展Claude的能力。 license: 完整条款见LICENSE.txt progressive_disclosure: entry_point: summary: “创建模块化技能，通过结构化组件扩展Claude的专业知识、工作流和工具” when_to_use: “当用户想要创建或更新具有专业知识、工作流或工具集成的技能时。专注于技能大于150行的渐进式披露。” quick_start: “1. 通过具体示例理解技能 2. 规划可复用组件（脚本/参考资料/资产） 3. 使用init_skill.py初始化 4. 编辑SKILL.md和资源 5. 打包和验证 6. 基于使用迭代” references: - skill-structure.md - creation-workflow.md - progressive-disclosure.md - best-practices.md - examples.md

技能创建器

概述

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

本技能示范了其自身的教学，通过使用渐进式披露保持入口点精简，同时在参考文件中提供详细内容。

何时使用本技能

激活时：

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

核心原则

示例驱动设计：从具体使用示例开始，而非抽象概念
渐进式披露：保持入口点<200行（理想：140-160行），详细内容在参考资料中
可复用组件：为重复代码提取脚本，为知识提取参考资料，为模板提取资产
命令式语气：全程使用动词优先指令（非第二人称）
专用资源：每个组件应解决特定重复需求

技能提供的内容

四大核心能力：

专业工作流 - 特定领域的多步骤程序
工具集成 - 使用文件格式或API的指令
领域专业知识 - 公司特定知识、模式、业务逻辑
捆绑资源 - 复杂任务的脚本、参考资料和资产

三级加载系统：

元数据（名称 + 描述）- 始终在上下文中（约100词）
SKILL.md主体 - 当技能触发时（<200行，理想：140-160行）
捆绑资源 - 按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 (必需)           # 入口点，带前端和Markdown
├── scripts/ (可选)           # 可执行代码（Python/Bash）
├── references/ (可选)        # 按需加载的文档
└── assets/ (可选)            # 输出模板、图像、文件

组件指南：

脚本：当相同代码被重复重写或需要确定性执行时
参考资料：用于详细规格、工作流、模式、API文档（每份150-500行）
资产：用于输出模板、样板、图像、字体
入口点：核心工作流、导航、提醒（理想140-160行）

→ 完整结构指南

渐进式披露模式

何时应用： 技能总行数>150行

实现：

添加progressive_disclosure前端，包含摘要、何时使用、快速开始
减少入口点至140-160行（核心工作流 + 导航）
创建3-5个参考文件（每份150-500行）
按主题组织：结构、工作流、最佳实践、示例
添加导航部分链接所有参考资料

好处：

入口仅加载基本内容
深度详情在需要时可用
更好的组织和可维护性
入口点大小减少20-30%

→ 完整渐进式披露指南

元示例： 本技能创建器示范渐进式披露：

入口：150行（从209行减少28%）
参考资料：5个文件，含完整实现详情
最近优化：mcp-builder（160行）、testing-anti-patterns（140行）

关键提醒

从示例开始 - 设计前收集3-5个具体使用场景
使用初始化脚本 - scripts/init_skill.py自动创建正确结构
命令式语气 - “要完成X，做Y”（非“你应该做X”）
渐进式披露 - 入口<200行，详情在参考资料中（针对技能>150行）
避免重复 - 信息存放在一个地方（入口摘要，参考详情）
组件清晰 - 脚本用于代码，参考资料用于知识，资产用于模板
分享前验证 - scripts/package_skill.py验证和打包
持续迭代 - 在实际任务中使用，基于困难更新

红旗 - 停止

如果您发现自己：

“让我把所有详情写在SKILL.md中” → 移至参考资料（渐进式披露）
“我将使用第二人称” → 切换到命令式语气
“入口和参考资料中相同信息” → 删除重复
使用通用描述 → 具体说明激活条件
保留初始化脚本的示例文件 → 删除未用资源
跳过验证 → 分享前始终运行package_skill.py
创建没有示例的技能 → 先收集具体使用场景
入口点>200行 → 应用渐进式披露模式

所有这些都意味着：停止。回顾原则和参考资料。

与其他技能的集成

元技能：

技能创建器（本技能）- 创建其他技能，示范自身模式

开发技能：

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

工作流技能：

documentation - 编写清晰、结构化内容
verification-before-completion - 打包前测试技能

现实世界影响

从技能优化经验：

渐进式披露：入口点大小减少20-30%
mcp-builder：209 → 160行（减少23%，6个参考资料）
testing-anti-patterns： → 140行（超精简，4个参考资料）
技能创建器：209 → 150行（减少28%，5个参考资料）
上下文效率：仅加载所需参考资料（节省50-80%上下文）
可维护性：更新特定参考资料而无需触碰入口点
清晰度：更好组织提高可发现性和理解

记住： 技能是模块化包，将Claude转变为专业代理。对技能>150行应用渐进式披露。本技能示范了其所教授的模式。

技能创建器Skill skill-creator