skill-creator

用途

Skill Creator 是一个指导型技能，用于帮助用户创建新的技能（Skill）或更新已有技能，从而扩展 Claude 的能力。技能是模块化、自包含的包，通过提供专门的知识、工作流和工具来扩展 Claude 的能力，可将其视为特定领域或任务的“入职指南”，把通用型 Claude 转变为具备程序性知识的专用型 Claude。

技能能提供什么

专门工作流：针对特定领域的多步骤流程
工具集成：处理特定文件格式或 API 的说明
领域专业知识：公司特定知识、模式、业务逻辑
捆绑资源：用于复杂和重复任务的脚本、参考资料和资产

核心原则

简洁是关键：上下文窗口是公共资源，技能与系统提示、对话历史、其他技能元数据及用户请求共享上下文窗口。默认假设 Claude 已经很聪明，只添加 Claude 尚不具备的上下文。优先使用简洁示例而非冗长解释。

设置适当的自由度：根据任务的脆弱性和可变性匹配具体程度。高自由度（基于文本的指令）适用于多种方法有效、决策依赖上下文或启发式引导的情况；中自由度（伪代码或带参数的脚本）适用于存在首选模式、允许一定变化或配置影响行为的情况；低自由度（特定脚本、少量参数）适用于操作脆弱易错、一致性关键或必须遵循特定顺序的情况。

技能的结构

每个技能由必需的 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 frontmatter（name 和 description 字段，这是 Claude 判断技能何时被使用的唯一字段）和 Markdown 正文（仅在技能触发后加载）。

Scripts（scripts/）：可执行代码，用于需要确定性可靠性或反复重写的任务。例如 scripts/rotate_pdf.py 用于 PDF 旋转任务。优点是 token 高效、确定性、可无需加载到上下文即可执行。

References（references/）：按需加载到上下文以指导 Claude 过程的文档和参考资料。例如财务模式、公司 NDA 模板、公司政策、API 规范。适用于数据库模式、API 文档、领域知识、公司政策、详细工作流指南。最佳实践：如果文件很大（超过 1 万词），在 SKILL.md 中包含 grep 搜索模式。避免重复：信息应只存在于 SKILL.md 或 references 文件之一。

Assets（assets/）：不打算加载到上下文，而是在 Claude 产生的输出中使用的文件。例如品牌资产、PowerPoint 模板、HTML/React 样板、字体。适用于模板、图像、图标、样板代码、字体、被复制或修改的示例文档。

不应包含在技能中的内容

技能应只包含直接支持其功能的基本文件。不要创建无关的文档或辅助文件，包括 README.md、INSTALLATION_GUIDE.md、QUICK_REFERENCE.md、CHANGELOG.md 等。

渐进式披露设计原则

技能使用三级加载系统高效管理上下文：

元数据（name + description）- 始终在上下文中（约 100 词）
SKILL.md 正文 - 技能触发时（少于 5000 词）
捆绑资源 - 按 Claude 需要（无限，因为脚本可执行而无需读入上下文窗口）

渐进式披露模式：

模式 1：带参考的高级指南。在 SKILL.md 中保留快速开始和高级功能链接，Claude 仅在需要时加载 FORMS.md、REFERENCE.md 或 EXAMPLES.md。
模式 2：领域特定组织。按领域组织内容以避免加载无关上下文，如 bigquery-skill 下分 finance.md、sales.md、product.md、marketing.md。
模式 3：条件细节。显示基本内容，链接到高级内容。

重要指南：避免深层嵌套引用，保持引用距 SKILL.md 一层深度；对超过 100 行的较长引用文件，在顶部包含目录。

技能创建流程

用具体示例理解技能：明确技能将如何被使用的具体示例，可通过直接用户示例或经用户反馈验证的生成示例获得。
规划可复用技能内容：分析每个示例，识别重复执行这些工作流时有帮助的脚本、参考资料和资产。
初始化技能：从零创建新技能时，始终运行 init_skill.py 脚本。用法：scripts/init_skill.py <skill-name> --path <output-directory>。该脚本创建技能目录、生成带正确 frontmatter 和 TODO 占位符的 SKILL.md 模板、创建示例资源目录并添加示例文件。
编辑技能：为另一个 Claude 实例使用而创建。先实现可复用资源（scripts/、references/、assets/），添加的脚本必须实际运行测试。更新 SKILL.md 时始终使用祈使/不定式形式。frontmatter 中 description 是主要触发机制，应包含技能做什么以及何时使用的具体触发条件，所有“何时使用”信息放在这里而非正文。
打包技能：开发完成后打包为可分发的 .skill 文件。用法：scripts/package_skill.py <path/to/skill-folder>，可选指定输出目录：scripts/package_skill.py <path/to/skill-folder> ./dist。打包脚本会自动验证 YAML frontmatter 格式和必需字段、技能命名约定和目录结构等。
基于实际使用迭代。

适用场景

适用于用户希望创建新技能或更新现有技能以扩展 Claude 能力的场景，尤其适合需要将特定领域知识、工作流或工具集成封装为可复用技能的情况。

限制

资料未提供该技能的具体收费、价格、平台支持范围及效果保证等信息。