Skill Creator（技能创建器）
一份指导你为 Claude 创建高质量技能的元技能，从需求梳理到打包分发提供完整流程。
该 skill 为纯指导型文档加三个本地 Python 脚本：init_skill.py 仅创建目录和模板文件，package_skill.py 仅打包 zip，quick_validate.py 仅做正则校验，无网络请求、无凭证读写、无删除操作，权限面很小，风险可见。扣分项：脚本写入文件无确认或回滚机制，SKILL.md 未声明脚本副作用与数据流向，来源归属（实质源自 Anthropic skills）未在 skill 内部标注。
脚本内部自洽：init_skill.py 参数校验与错误提示清晰，package_skill.py 在打包前强制校验并在失败时中止，quick_validate.py 检查合理且给出可读的失败信息。扣分项：三个脚本均无对应测试，正则式 frontmatter 校验较粗糙（如多行 description 会漏检），未执行验证，异常输入下的行为只能推断。
description 明确触发条件（创建/更新 skill），六步流程与示例清晰，面向的受众和使用场景明确；脚本不依赖海外服务，中文环境可运行（内容为英文但不构成阻断）。扣分项：未声明不适用边界（如与 skill 无关的文档写作请求），无中文支持说明，触发精度仅有文字描述、缺乏反例。
SKILL.md 分层清晰（元数据→正文→渐进披露），带 name/description/license 元数据，仓库为 MIT 许可，README 与文档体系完善，submodule 方式引入。扣分项：frontmatter 引用的 LICENSE.txt 在仓库中未见对应文件，skill 自身无版本号、无 changelog，维护责任与更新路径仅隐含在仓库层面。
指导内容结构化且可操作（含 init/validate/package 三个可执行脚本），对'创建 Claude 风格 skill'这一任务有明确边际价值，优于用户手动摸索。扣分项：静态评审未执行，输出（生成的 skill 模板）质量未经验证，与直接使用上游 Anthropic skills 相比新增价值有限，成本收益比例证据不足。
可审计一手材料完整（SKILL.md 与三个脚本源码均可独立审读），事实与推断可分离。扣分项：无任何针对本 skill 的测试或 CI 覆盖证据，无第三方执行佐证，'脚本可运行、校验有效'等关键声明只能静态推断，覆盖率薄。
- 静态评审，未执行任何脚本；脚本行为与校验结果仅为源码推断。
- frontmatter 引用的 LICENSE.txt 在所提供文件中不存在，许可归属仅能依赖仓库级 MIT 声明。
- skill 内容实质源自 Anthropic 官方 skills（README References 有暗示），skill 内部未标注出处。
- package_skill.py 通过同目录导入 quick_validate，目录结构调整会破坏导入；init_skill.py 会直接覆盖路径上的同名目录（报错退出，但无回滚）。
- 仓库测试依赖真实 MiniMax API key，test_agent.py 实为需联网的手工验证，不构成对该 skill 的自动化验证。
这个 Skill 能做什么，适合哪些场景？
skill-creator 是一个教授'如何制作技能'的技能。它系统讲解技能的结构规范（SKILL.md 加可选的 scripts/references/assets 目录）、渐进式披露的上下文管理原则，以及一个六步创建流程。流程涵盖：用具体用例理解需求、规划可复用资源、用脚本初始化模板、编写与编辑内容、打包校验，以及上线后迭代。适合希望把自己的领域知识固化为可复用技能包的开发者与高级用户。
读取用户对目标技能的使用场景描述；通过提问澄清功能范围与触发条件；分析每个示例以决定需要哪些脚本、参考文档和素材；运行 scripts/init_skill.py 生成带 YAML frontmatter 的模板目录；指导以祈使句风格撰写 SKILL.md；运行 scripts/package_skill.py 校验（检查 frontmatter、命名规范、描述完整性、文件组织）并输出可分发的 zip 包；在真实使用后按迭代流程修订内容。
- 团队工程师想把公司内部的 API 规范或数据库 schema 沉淀为团队共享技能
- 内容运营人员想把自己的文档模板和品牌素材打包成可复用资产
- 高级 Claude 用户发现某类任务（如 PDF 处理）反复重写相同代码，想封装成脚本技能
- 技能维护者在收到使用反馈后，需要按流程迭代更新已有技能并重新打包
- 新手上手 Agent Skills 标准，需要一份结构规范与最佳实践参考
这个 Skill 有哪些优点和局限？
- 提供完整、有序的六步创建流程，减少随意性
- 内置模板生成与打包校验脚本，产出符合规范的技能包
- 系统讲解渐进式披露原则，帮助控制上下文占用
- 包含大量具体示例（PDF 编辑、前端模板、BigQuery 查询）便于理解
- 脚本的完整依赖与运行环境要求在技能文件中未详细列出
- 技能质量依赖使用者对领域的清晰描述，示例收集阶段需要较多交互
- README 描述的是整个 Mini-Agent 集合（15 个技能），该技能自身没有独立的测试说明
- 面向 Claude 生态编写，在其他 Agent 平台使用可能需要调整措辞与工具引用
如何安装这个 Skill？
该技能随 Mini-Agent 仓库分发。快速方式：uv tool install git+https://github.com/MiniMax-AI/Mini-Agent.git，然后运行官方 setup 脚本并配置 ~/.mini-agent/config/config.yaml 中的 api_key 与 api_base。开发方式：git clone 仓库后执行 uv sync，并通过 git submodule update --init --recursive 拉取技能子模块。技能位于 mini_agent/skills/skill-creator/。单独把该技能文件夹复制到其他支持 Agent Skills 的客户端的方法，源材料未说明。
如何使用这个 Skill？
在支持技能的 Agent 中用自然语言触发，例如：'帮我创建一个用于编辑 PDF 的技能'。技能会先询问具体使用示例，再规划脚本/参考/素材，运行 scripts/init_skill.py <skill-name> --path <output-directory> 生成模板；编辑完成后运行 scripts/package_skill.py <skill-folder> 完成校验并生成 zip 包；可选指定输出目录 ./dist。校验失败会报错且不打包，需修正后重跑。
这个 Skill 与同类方案有什么区别？
Mini-Agent 仓库本身集成了 15 个 Claude Skills（源自 Anthropic 的技能体系），本技能是其中唯一一个'制造其他技能'的元技能；同类替代是直接参考 Anthropic 官方 skills 仓库的文档，但本技能将其流程化并附带了初始化与打包脚本。