一、前置条件1. 运行环境只能在 **Claude‑Code CLI终端版**使用网页版 claude.ai 只有简化版不支持自动评测evals和benchmark版本要求claude‑code v2.1.78Python3.10用来运行评测脚本。2. 安装 skill‑creator官方元技能方式1插件市场一键安装推荐进入 Claude‑Code 的对话终端执行# 添加官方技能仓库/plugin marketplaceaddanthropics/skills# 安装 skill‑creator/plugininstallskill‑creator安装完成重启 Claude‑Code才会加载全局存放路径Mac/Linux~/.claude/skills/skill‑creatorWindows%USERPROFILE%\.claude\skills\skill‑creator方式2手动部署断网环境gitclone https://github.com/anthropics/skills.gitcp-rskills/skill‑creator ~/.claude/skills/3. 调用入口两种方式任选其一1斜杠命令最标准# 创建新技能/skill‑creator create# 对已有技能做评测/skill‑creatoreval./my‑skill# 根据评测结果自动改进skill/skill‑creator improve ./my‑skill# 基准压测多次运行降低随机性/skill‑creator benchmark ./my‑skill--runs152自然语言触发不用记命令Use skill‑creator to build a skill for Java code security review帮我用skill‑creator创建Java代码安全审查的skill二、4个核心模式完整用法实操步骤模式1create从零新建Skill最常用Step1输入需求描述尽量具体进入claude‑code后输入/skill‑creator create随后AI会交互式向你确认4个关键问题你依次回答即可技能目标这个技能解决什么问题坏示例做代码审查好示例读取项目Java文件检测硬编码密钥、SQL注入输出JSON结果。触发条件非常关键什么时候启用本Skill例用户提到代码审查、漏洞扫描、查看java文件时触发闲聊内容不启用。允许调用工具allowed‑toolsbash、read_file、edit_file等输出规范 禁止行为输出格式JSON / Markdown表格 / 纯文本禁止不要多余闲聊只输出结果禁止编造文件不存在的代码。Step2skill‑creator自动生成目录文件它会自动生成整套目录你不用手动建文件夹~/.claude/skills/my‑java‑review/ ├─ SKILL.md # 核心文件包含yaml元数据 指令 示例 └─ evals/evals.json # 自动生成测试用例与断言条件SKILL.md自动填充yaml头部---name:java‑security‑reviewdescription:读取Java源码文件检查SQL注入、硬编码密钥返回JSON漏洞报告用户提出代码审查时启用allowed‑tools:[read_file,bash]---# 下面是你的业务指令和示例命名规范文件夹名称必须小写短横线kebab‑case。Step3自动跑eval测试双对照组skill‑creator内部启动两组Agent实验组加载你的skill运行测试用例对照组原生Claude不加载skill内置Grader判断正向用例应该触发技能反向用例闲聊内容绝对不触发断言要求输出格式合规、漏洞识别正确。如果通过率低Analyzer会指出SKILL.md哪条描述模糊并给出修改建议。Step4确认交付成果评测达标 → 技能正式生效之后在任意项目里输入/java‑security‑review src/main/java即可调用不满意输入improve自动迭代项目级部署把my‑java‑review复制到项目目录.claude/skills仅当前仓库生效放到~/.claude/skills全局所有项目生效。模式2eval评测已有skill/skill‑creatoreval~/.claude/skills/my‑skill读取现有的evals/evals.json自动执行全部测试用例输出通过率、失败用例、失败原因若你没有evals.jsonskill‑creator会帮你生成可验证的断言用例。evals.json编写规则skill‑creator自动生成你只需看懂{evals:[{prompt:审查src/login.java,expectations:[输出JSON格式,识别硬编码密码漏洞,漏洞包含等级、问题代码片段、修复建议]},{prompt:今天天气怎么样,expectations:[不要触发代码审查技能]}]}expectations必须客观可判断不能写“回答要好”这类模糊描述。模式3improve迭代优化/skill‑creator improve ./my‑skill工作逻辑读取eval评测失败的case修改SKILL.md的触发条件、规则、示例再次运行eval直到通过率达标大多数时候只是优化描述语句不要堆砌大量指令文本。模式4benchmark基准压力测试上线前必做/skill‑creator benchmark ./my‑skill--runs15多次循环跑测试用例消除单次运行随机性确保后续模型版本更新之后技能依然稳定跑完生成timing.json记录耗时、token消耗。三、手动修改SKILL.md后如何生效修改完成后执行/skill‑creatoreval./my‑skill全部用例通过后重启Claude‑Code调用方式二选一自动触发输入对应场景问题Claude‑Code自动匹配加载skill手动强制调用/my‑skill 你的参数。四、官方最佳实践避坑要点SKILL.md精简原则核心规则和示例写在SKILL.md长篇参考文档放到references/文件夹避免主文件过长SKILL.md正文控制在5000字以内。示例必不可少至少写2组「用户输入‑模型输出示例」大幅提高触发准确率客观任务代码、格式处理必须写evals写文案类主观任务可以人工评审不要开启过多技能同时启用技能建议控制在20‑50个以内否则匹配混乱、上下文膨胀技能打包分享# 官方打包脚本生成可分发压缩包python ~/.claude/skills/skill‑creator/scripts/package_skill.py ./my‑skill ./dist别人拿到后放到自己~/.claude/skills即可直接使用。五、最简实操演示复制即可跑通打开claude‑code执行/skill‑creator create你的回答技能名称git‑commit‑helper功能根据代码改动生成符合Conventional‑Commits规范的commit‑message仅用户说生成commit注释时触发输出简短一行无多余文字。等待AI生成文件并跑完评测使用/git‑commit‑helper即可生成提交注释。
一、前置条件1. 运行环境只能在 **Claude‑Code CLI终端版**使用网页版 claude.ai 只有简化版不支持自动评测evals和benchmark版本要求claude‑code v2.1.78Python3.10用来运行评测脚本。2. 安装 skill‑creator官方元技能方式1插件市场一键安装推荐进入 Claude‑Code 的对话终端执行# 添加官方技能仓库/plugin marketplaceaddanthropics/skills# 安装 skill‑creator/plugininstallskill‑creator安装完成重启 Claude‑Code才会加载全局存放路径Mac/Linux~/.claude/skills/skill‑creatorWindows%USERPROFILE%\.claude\skills\skill‑creator方式2手动部署断网环境gitclone https://github.com/anthropics/skills.gitcp-rskills/skill‑creator ~/.claude/skills/3. 调用入口两种方式任选其一1斜杠命令最标准# 创建新技能/skill‑creator create# 对已有技能做评测/skill‑creatoreval./my‑skill# 根据评测结果自动改进skill/skill‑creator improve ./my‑skill# 基准压测多次运行降低随机性/skill‑creator benchmark ./my‑skill--runs152自然语言触发不用记命令Use skill‑creator to build a skill for Java code security review帮我用skill‑creator创建Java代码安全审查的skill二、4个核心模式完整用法实操步骤模式1create从零新建Skill最常用Step1输入需求描述尽量具体进入claude‑code后输入/skill‑creator create随后AI会交互式向你确认4个关键问题你依次回答即可技能目标这个技能解决什么问题坏示例做代码审查好示例读取项目Java文件检测硬编码密钥、SQL注入输出JSON结果。触发条件非常关键什么时候启用本Skill例用户提到代码审查、漏洞扫描、查看java文件时触发闲聊内容不启用。允许调用工具allowed‑toolsbash、read_file、edit_file等输出规范 禁止行为输出格式JSON / Markdown表格 / 纯文本禁止不要多余闲聊只输出结果禁止编造文件不存在的代码。Step2skill‑creator自动生成目录文件它会自动生成整套目录你不用手动建文件夹~/.claude/skills/my‑java‑review/ ├─ SKILL.md # 核心文件包含yaml元数据 指令 示例 └─ evals/evals.json # 自动生成测试用例与断言条件SKILL.md自动填充yaml头部---name:java‑security‑reviewdescription:读取Java源码文件检查SQL注入、硬编码密钥返回JSON漏洞报告用户提出代码审查时启用allowed‑tools:[read_file,bash]---# 下面是你的业务指令和示例命名规范文件夹名称必须小写短横线kebab‑case。Step3自动跑eval测试双对照组skill‑creator内部启动两组Agent实验组加载你的skill运行测试用例对照组原生Claude不加载skill内置Grader判断正向用例应该触发技能反向用例闲聊内容绝对不触发断言要求输出格式合规、漏洞识别正确。如果通过率低Analyzer会指出SKILL.md哪条描述模糊并给出修改建议。Step4确认交付成果评测达标 → 技能正式生效之后在任意项目里输入/java‑security‑review src/main/java即可调用不满意输入improve自动迭代项目级部署把my‑java‑review复制到项目目录.claude/skills仅当前仓库生效放到~/.claude/skills全局所有项目生效。模式2eval评测已有skill/skill‑creatoreval~/.claude/skills/my‑skill读取现有的evals/evals.json自动执行全部测试用例输出通过率、失败用例、失败原因若你没有evals.jsonskill‑creator会帮你生成可验证的断言用例。evals.json编写规则skill‑creator自动生成你只需看懂{evals:[{prompt:审查src/login.java,expectations:[输出JSON格式,识别硬编码密码漏洞,漏洞包含等级、问题代码片段、修复建议]},{prompt:今天天气怎么样,expectations:[不要触发代码审查技能]}]}expectations必须客观可判断不能写“回答要好”这类模糊描述。模式3improve迭代优化/skill‑creator improve ./my‑skill工作逻辑读取eval评测失败的case修改SKILL.md的触发条件、规则、示例再次运行eval直到通过率达标大多数时候只是优化描述语句不要堆砌大量指令文本。模式4benchmark基准压力测试上线前必做/skill‑creator benchmark ./my‑skill--runs15多次循环跑测试用例消除单次运行随机性确保后续模型版本更新之后技能依然稳定跑完生成timing.json记录耗时、token消耗。三、手动修改SKILL.md后如何生效修改完成后执行/skill‑creatoreval./my‑skill全部用例通过后重启Claude‑Code调用方式二选一自动触发输入对应场景问题Claude‑Code自动匹配加载skill手动强制调用/my‑skill 你的参数。四、官方最佳实践避坑要点SKILL.md精简原则核心规则和示例写在SKILL.md长篇参考文档放到references/文件夹避免主文件过长SKILL.md正文控制在5000字以内。示例必不可少至少写2组「用户输入‑模型输出示例」大幅提高触发准确率客观任务代码、格式处理必须写evals写文案类主观任务可以人工评审不要开启过多技能同时启用技能建议控制在20‑50个以内否则匹配混乱、上下文膨胀技能打包分享# 官方打包脚本生成可分发压缩包python ~/.claude/skills/skill‑creator/scripts/package_skill.py ./my‑skill ./dist别人拿到后放到自己~/.claude/skills即可直接使用。五、最简实操演示复制即可跑通打开claude‑code执行/skill‑creator create你的回答技能名称git‑commit‑helper功能根据代码改动生成符合Conventional‑Commits规范的commit‑message仅用户说生成commit注释时触发输出简短一行无多余文字。等待AI生成文件并跑完评测使用/git‑commit‑helper即可生成提交注释。
