skill-creator：写、改、评估技能的官方技能

什么时候用

• 想从零写一个技能，或改进已有技能，并希望有一套“起草、跑测试用例、看结果、再改”的流程。[1]
• 技能写好后，想检查它的 description 能不能在该触发的时候触发，并按官方脚本优化描述（需要 claude 命令行）。[1]
• 想对照 Claude Code 文档，确认 SKILL.md 的 frontmatter 和目录结构怎么写。[6]
• 简单技能、不想做评估时也能用：官方说用户可以说“不用跑一堆评估”，这时可以不走完整评估流程（这是步骤限制，不是整体不适用）。[1]

什么时候不用

• 只是要用现成技能做日常任务，而不是创建、修改或评估技能：description 的范围是“创建新技能、修改改进已有技能、衡量技能表现”。官方没有单独列出不适用场景，这一条是按 description 范围和任务边界做的推断。[1]

它做什么

官方 description：创建新技能、修改并改进已有技能、衡量技能表现；用户想从零建技能、编辑或优化、跑评估、做带方差分析的基准对比，或优化描述的触发准确度时使用。[1]

• 决定技能要做什么，写一份草稿。
• 准备几条测试提示，用“带上这个技能的 Claude”去跑；新建技能时每条另跑一路不带技能的 baseline，改进已有技能时 baseline 用改动前的旧版本。
• 用 eval-viewer/generate_review.py 把结果给用户看，同时看量化指标。
• 根据反馈重写技能，反复到满意为止，再扩大测试集。
• 技能完成后，可以再跑描述优化脚本改进触发（需要 claude 命令行，条件见下）；若环境有 present_files 工具，还可以用 package_skill 打包成 .skill 文件。

[1]

步骤限制（不是整体不适用）：用户可以跳过评估；描述优化步骤需要 claude 命令行（claude -p），没有时跳过该步骤；Claude.ai 没有子代理，要串行跑用例并跳过 baseline 与量化基准。这些只缩减流程，技能其余部分仍可用。[1]

技能文件格式：以 Claude Code 文档为准

[6]

my-skill/
├── SKILL.md (required - overview and navigation)
├── reference.md (detailed API docs - loaded when needed)
├── examples.md (usage examples - loaded when needed)
└── scripts/
    └── helper.py (utility script - executed, not loaded)

[6]

skill-creator 自己的 SKILL.md 写“YAML frontmatter (name, description required)”，且它的 quick_validate.py 在缺 name 时返回 “Missing 'name' in frontmatter”，并建议 SKILL.md 控制在 500 行以内、把大块资料放进 scripts/、references/、assets/。Claude Code 文档则写“All fields are optional”，name 缺省为目录名。这是两个来源各自的说法：前者是 skill-creator 的写作与校验规范，后者是 Claude Code 的文档；官方没有解释两者关系，待确认。[1][8][6]

怎么调用、怎么装

[1][6][4][5][2][3]

/plugin marketplace add anthropics/skills
/plugin install example-skills@anthropic-agent-skills

[4][5]

依赖与没写明的事

• Python：评估聚合、描述优化、打包都用 python -m scripts.<名字> 的形式运行。SKILL.md 写打包脚本“works anywhere with Python and a filesystem”；核对固定版本脚本后补充：package_skill.py 会先调用 quick_validate.py，后者 import yaml（第三方库 PyYAML，不在 Python 标准库内），所以打包还需要能 import yaml；官方没有写明怎么装 PyYAML。
• claude 命令行：描述优化（run_loop）需要 claude -p。Claude.ai 一节写它“只在 Claude Code 可用”，Cowork 一节写它通过 claude -p 子进程“应该可以正常使用”；两处说法不一致，按有没有 claude 命令行限定，待确认。run_eval.py 和 improve_description.py 都调用 claude -p，improve_description.py 注释称沿用当前会话的 Claude Code 认证、不需要单独的 ANTHROPIC_API_KEY。
• 临时文件：run_eval.py 在项目根（向上找 .claude 目录）的 .claude/commands/ 写一个临时命令文件，用完在 finally 中删除；运行描述优化的账户需要对该目录有写权限（推断）。
• 浏览器：评估查看器默认在浏览器打开；没有显示环境时用 --static 输出独立 HTML。
• 子代理与对照：每个测试用例要同时起带技能和对照两路。新建技能时对照是不带技能；改进已有技能时对照是改动前的旧版本快照；Claude.ai 没有子代理，官方给了串行做法并跳过 baseline。
• 账号、权限、费用：官方未写明账号类型和权限要求（描述优化沿用会话认证，见上）；费用金额官方没给。多路子代理和 claude -p 会消耗用量，这是按正文做法的推断。

[1][7][8][9][10]