用途:skill-craft 用于创建、评估与审查 Claude Code 技能(skills)及可复用智能体定义文件,涉及结构、frontmatter 与 evals。它先做判断——“该不该建、建什么类型”,再进入构建或审查流程。判断性工作(需求受理、设计、编写评估、解读、编辑)在此完成;可校验的部分(校验、触发探针、运行生成、评分、结论、统计、打包)经由 skill-eval MCP 工具执行,合规结论不得手工填写。
模式路由:想新建(“为 X 写一个技能”)走 CREATE 流程;审计已有技能(SKILL.md 或技能目录路径)走 REVIEW,加载本技能目录下的 references/review-skill.md;只想审查智能体定义里的提示词正文或派发简报,则转交 oberskills:prompt REVIEW;改进已有技能从 CREATE 第 3 阶段(BASELINE)开始,以旧技能快照作为基线配置;请求含糊时先询问或调用 oberskills:clarify。
预门槛:先看 Claude 不做技能能否做好,没有记录到失败就不要构建;写不出三个 evals 就不要建;预计使用不足 5 次就只完成任务;始终相关且内容小,则放 CLAUDE.md 而非技能。
构建类型判断:可复用流程或领域知识 → 技能(默认);用户控制的副作用宏(部署、发布等)→ 技能加 disable-model-invocation: true;后台约定 → 技能加 user-invocable: false;会淹没主上下文的工作(日志、搜索结果、批量读取)→ 子智能体;需要每次事件强制保证 → 钩子;确定的重复计算 → 技能内捆绑脚本;始终相关的小型项目事实 → CLAUDE.md;既能复用又需隔离 → 技能加 context: fork。
CREATE 流程为六阶段:INTAKE、DESIGN、BASELINE、BUILD、EVAL、SHIP,各有加载文件与 skill-eval 工具,并有“仅当某条件通过才继续”的门槛。先写基线,基线失败即规格;EVAL 中要求 with-skill 在差距断言上胜过基线、触发准确率双向通过,最多迭代 3 次。
硬限制(以 validate_skill 输出为准):name 不超过 64 字符,小写字母数字与连字符,须与目录名一致,不得含 anthropic/claude;description 为 1–1024 字符、第三人称、无 XML 标签;description 与 when_to_use 列表合计默认截断于 1536 字符;SKILL.md 正文硬上限 500 行,建议低于 5k tokens;引用只允许一层深度;发布前至少 3 个 evals。
skill-eval 工具包括 validate_skill、test_triggers、optimize_description、run_eval、grade_run、aggregate_benchmark、compare_outputs;工具缺失说明服务未运行,Claude Code 用户可运行 /reload-plugins,Codex/本地用户需在插件 mcp/ 目录运行 bun install 后重启或重装会话。
编写原则:只补 Claude 没有的上下文,指令应是长期有效的而非一次性步骤,不要过度提示;用门槛与外部确定性检查代替说服;脆弱流程给精确脚本,开放式工作给启发式规则;质量关键输出加反馈回路。
集成:技能正文属提示词,适用 oberskills:prompt 的 DESIGN 原则,其 REVIEW 负责所有提示词措辞审查;派发子智能体由 oberskills:agent 负责模型与 effort 选择;含糊受理交给 oberskills:clarify。定价、平台支持范围等资料未提供。