用途
skill-creator 是一个用于创建有效技能的指导技能。当用户希望创建新技能，或更新已有的、用于扩展 Claude 能力的技能时，应使用该技能。它本身是一个方法论文档，提供从理解需求到打包发布的完整流程与设计原则。
什么是技能
技能是模块化、自包含的包，通过提供专门的知识、工作流和工具来扩展 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，含 name 和 description 字段，这是 Claude 用于判断何时使用该技能的唯一字段，因此描述其功能和使用时机时必须清晰全面）和正文（Markdown，使用技能的说明与指导，仅在技能触发后加载）。
配套资源（可选）：scripts/ 存放可执行代码（Python/Bash 等），用于需要确定性可靠性或反复重写代码的任务；references/ 存放需要时加载进上下文的文档与参考资料，如数据库模式、API 文档、领域知识、公司政策、详细工作流指南，可保持 SKILL.md 精简；assets/ 存放不加载进上下文、而是用于最终输出中的文件，如模板、图片、图标、样板代码、字体、示例文档。
不应包含的内容
技能只应包含直接支持其功能的必要文件。不要创建多余文档或辅助文件，包括 README.md、INSTALLATION_GUIDE.md、QUICK_REFERENCE.md、CHANGELOG.md 等。技能只应包含 AI 智能体完成手头工作所需的信息，不应包含关于创建过程的辅助背景、安装测试流程、面向用户的文档等。额外的文档文件只会增加杂乱和困惑。
渐进式披露设计原则
技能使用三级加载系统高效管理上下文：元数据（名称 + 描述）始终在上下文中（约 100 词）；SKILL.md 正文在技能触发时加载（少于 5000 词）；配套资源由 Claude 按需使用（不限量，因为脚本可不读入上下文窗口直接执行）。
组织模式：
模式一，高层指南加参考：SKILL.md 中保留快速开始和功能概览，将表单填写、API 参考、示例等指向独立文件，Claude 仅在需要时加载。
模式二，按领域组织：为多领域技能按领域组织内容，如 bigquery-skill 的 reference/ 下分为 finance.md、sales.md、product.md、marketing.md，用户询问销售指标时只读取 sales.md。支持多框架或变体的技能同理按变体组织，如 cloud-deploy 按 aws.md、gcp.md、azure.md 划分。
模式三，条件细节：展示基础内容并链接到高级内容，如 DOCX 处理中创建文档指向 DOCX-JS.md，简单编辑直接改 XML，跟踪修订指向 REDLINING.md，OOXML 细节指向 OOXML.md。
重要准则：避免深层嵌套引用，保持参考文件距 SKILL.md 一层深，所有参考文件应直接从 SKILL.md 链接；对超过 100 行的参考文件，在顶部加入目录以便预览时了解全貌。保持 SKILL.md 正文精简并在 500 行以内，接近限制时拆分内容，且拆分后必须在 SKILL.md 中引用并说明何时阅读。
技能创建流程
第一步：用具体示例理解技能。除非使用模式已明确，否则应执行。通过直接用户示例或经用户反馈验证的生成示例，清楚理解技能的具体使用方式。例如构建图像编辑器技能时，可询问应支持哪些功能、能否举例说明使用方式、用户会说什么话触发该技能。避免单条消息中问太多问题，先问最重要的。
第二步：规划可复用内容。分析每个示例，考虑如何从零执行，识别重复执行时需要哪些脚本、参考和资产。例如旋转 PDF 每次都要重写相同代码，可用 scripts/rotate_pdf.py；构建前端 Web 应用每次都要相同样板，可用 assets/hello-world/ 模板；查询 BigQuery 每次都要重新发现表结构，可用 references/schema.md。
第三步：初始化技能。从头创建新技能时始终运行初始化脚本：
scripts/init_skill.py <skill-name> --path <output-directory>
该脚本会创建技能目录、生成含正确前置元数据和 TODO 占位符的 SKILL.md 模板、创建 scripts/、references/、assets/ 示例目录并添加可自定义或删除的示例文件。
第四步：编辑技能。技能是给另一个 Claude 实例使用的，应包含对 Claude 有益且非显而易见的信息。可参考 references/workflows.md（多步骤流程与条件逻辑）和 references/output-patterns.md（特定输出格式或质量标准）。先从可复用资源入手，添加的脚本必须实际运行测试以确保无 bug 且输出符合预期，多个相似脚本只需测试有代表性的样本。不需要的示例文件和目录应删除。更新 SKILL.md 时始终使用祈使式/不定式写法，前置元数据只含 name 和 description，描述中要包含技能做什么以及何时使用的具体触发条件和上下文，所有“何时使用”的信息都应放在这里而非正文。
第五步：打包技能。开发完成后须打包为可分发的 .skill 文件：
scripts/package_skill.py <path/to/skill-folder>
scripts/package_skill.py <path/to/skill-folder> ./dist
打包脚本会自动验证技能，检查 YAML 前置元数据格式与必需字段、技能命名规范与目录结构等。
第六步：基于实际使用迭代。
适用场景
适用于需要创建新技能或更新既有技能，以扩展 Claude 能力的场景；也适用于已有技能需要迭代、调整结构或重新打包的情况。
限制
资料未提供该技能的安装方式、运行环境要求、收费与价格信息。资料中关于打包脚本验证项的说明在原文末尾被截断，未完整呈现。