create-skill 是一个用于创建可复用工作流技能（Skill）的指导工具，主要面向 Claude 使用场景。当用户希望自动化重复性工作、创建新技能或把某项流程沉淀为可复用能力时，可以加载该技能获得创建指导。
一、用途 该技能的核心目标是帮助用户创建模块化、自包含的技能包。技能被视为针对特定领域或任务的“入门指南”，可以把通用型 AI 转变为具备特定流程知识和工作方法的专用型 AI。当用户出现重复性操作模式，或连续创建高度相似的多个项目与文件时，该技能也用于识别这种反模式并建议改用技能方式实现。
二、主要能力 技能可以提供专门化工作流，即针对特定领域的多步骤流程；可以提供工具集成说明，即处理特定文件格式或 API 的操作指引；可以承载领域知识，例如组织特定的知识、数据模式或业务逻辑；还可以打包脚本、参考资料和素材等资源，用于复杂或重复执行的任务。
技能创建本身包含结构与规范指导，包括：以精简为原则，只补充 AI 不具备的上下文；根据任务的脆弱性和可变性设置不同程度的自由度；使用渐进式披露设计，控制不同层级内容的加载时机。
三、技能结构 每个技能由一个必需的 SKILL.md 文件和可选的捆绑资源组成。SKILL.md 分为 YAML frontmatter 与 Markdown 正文，frontmatter 必须包含 name 和 description 字段，用于决定技能何时被调用。捆绑资源分为三类：scripts 目录存放可执行代码，适用于需要确定性可靠性或会被反复重写的任务；references 目录存放按需加载进上下文的文档，适用于数据库模式、API 文档、领域知识、策略或详细流程指南；assets 目录存放不进入上下文、但会用于最终输出成果的文件，如模板、图标、字体、示例文档或前端样板。技能中不应包含 README.md、INSTALLATION_GUIDE.md、QUICK_REFERENCE.md、CHANGELOG.md 等无关文档。
四、渐进式披露 技能采用三级加载机制：元数据（名称与描述）始终在上下文中，约 100 词；SKILL.md 正文在技能触发时加载，少于 5000 词；捆绑资源由 AI 按需使用。建议 SKILL.md 正文保持精炼并控制在 500 行以内。当内容接近上限时，可拆分为多个文件，但引用应保持从 SKILL.md 出发的一级深度，避免深层嵌套；超过 100 行的参考文件建议在开头加入目录。SKILL.md 只保留核心工作流与选择指导，变体细节、具体模式、示例与配置应移入独立参考文件，并通过清晰的引用说明何时读取。参考文件中如体积很大（超过 1 万词），建议在 SKILL.md 中给出搜索模式。信息不应在 SKILL.md 和参考文件中重复，应优先放入参考文件，以保持 SKILL.md 精简。
五、使用方式 创建流程按顺序推进，包括：初始化任务跟踪；通过具体示例理解技能需求；规划可复用资源；运行 init_skill.py 初始化技能结构；实现资源并编写 SKILL.md；运行 package_skill.py 打包；根据真实使用情况迭代；结束后自动触发会话收尾以保存进度。只有在明确不适用的前提下才可跳过步骤。
开始时技能强制检查入门引导状态：若 learn_skills 出现在 stats.pending_onboarding 中，并且这是用户的第一个技能，则会提示是否先学习技能教程，用户可回复“learn skills”或“skip”；若用户选择 skip，则继续创建并在末尾提示之后可运行“learn skills”。若 learn_skills 不在待办入门列表中，则正常进行。流程中还包含反模式检测，当用户创建 report-jan、report-feb、report-mar 之类相似条目时，会提示这更适合做成技能。
理解需求阶段，技能会先检查最近 10 至 20 条对话是否存在可复用流程模式，若发现刚完成的多步骤流程，会提议保存为技能；否则通过提问澄清功能范围与触发方式，并避免一次性提出过多问题。
在需求明确后，技能会主动加载 mental-models 框架，推荐 2 至 3 个相关思维模型供用户选择，以深化技能设计，用户也可选择不使用结构化分析。用户选定后，再加载对应参考文件并应用其中的问题来细化设计。
六、适用场景 适用于用户想要创建技能、新增技能、自动化当前操作、制作可复用流程、保存工作流等场景；也适用于用户反复创建相似项目或文件，需要将其抽象成可复用技能的场景。
七、限制与说明 技能强调精简，不应包含与功能无直接关系的说明性文件。技能正文与资源有上下文控制要求，需要遵循渐进式披露原则。关于该技能的收费、价格、平台支持范围、具体效果以及 init_skill.py 和 package_skill.py 的详细用法，资料暂未提供。