skill-creator

用途

Skill Creator 是一个指导型技能，用于帮助用户创建有效的新技能（Skill），或更新已有技能，从而扩展 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/：可执行代码，用于需要确定性可靠性或反复重写的任务。
references/：按需加载到上下文中的文档和参考资料。
assets/：不加载到上下文、而是在输出中使用的文件（模板、图标、字体等）。

不应包含的内容

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

渐进式披露设计原则

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

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

SKILL.md 正文应保持精简，控制在 500 行以内。当支持多种变体、框架或选项时，只在 SKILL.md 中保留核心工作流和选择指导，将变体特定细节移入单独的参考文件。

技能创建流程

用具体示例理解技能：明确技能将如何被使用的具体示例，可通过用户示例或经用户反馈验证的生成示例获得。
规划可复用技能内容：分析每个示例，识别可复用的脚本、参考资料和资产。
初始化技能：运行 scripts/init_skill.py <skill-name> --path <output-directory>，生成包含 SKILL.md 模板和示例资源目录的模板技能目录。
编辑技能：实现资源并编写 SKILL.md。编写时始终使用祈使/不定式形式。frontmatter 中只包含 name 和 description 字段，description 需同时说明技能做什么以及何时使用。
打包技能：运行 scripts/package_skill.py <path/to/skill-folder>，自动验证并打包为可分发的 .skill 文件。可选指定输出目录：scripts/package_skill.py <path/to/skill-folder> ./dist。
基于实际使用迭代。

适用场景

适用于用户希望创建新技能或更新现有技能以扩展 Claude 能力的场景，例如构建图像编辑器技能、PDF 编辑器技能、前端 Web 应用构建技能、BigQuery 查询技能等。

限制

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