Agent Skills
由 Tian Wenyao 维护的一组可组合 Agent Skills，适用于 Codex、Claude Code 及其他兼容 Agent Skills 的工具。
这些 skills 来自真实工作流，强调可预测的过程、明确的完成标准和渐进披露。每个 skill 都由模型按任务触发， 边界互不重叠，也可以单独安装、单独分享。
安装
使用官方 skills CLI 浏览并安装：
# 查看仓库中的所有 skills
npx skills add ImWenyaoT/skills --list
# 交互式选择并安装
npx skills add ImWenyaoT/skills
# 全局安装指定 skill 到 Codex
npx skills add ImWenyaoT/skills --skill writing-papers -g -a codex -y
# 安装全部 skills
npx skills add ImWenyaoT/skills --all
也可以从本地 checkout 验证或安装：
npx skills add . --list
npx skills add . --skill publishing-papers
Skills
这些 skill 不是一套流程,彼此不依赖。按当下手头的问题装其中一个就能用。
| Skill | 什么时候拿它出来 |
|---|---|
training-models | 训练跑不对:loss 不下降、acc 卡住、梯度异常、训练验证不一致。 |
comparing-runs | 一堆跑完的 run 要变成一张经得起审的表:消融臂可比吗、基线复现、误差棒、每行能不能追回去。 |
writing-papers | 起草、审阅或润色技术论文的正文。 |
drawing-figures | 规划并制作出版级论文图表。 |
publishing-papers | 科学做完之后的所有事:期刊模板与本地编译、投稿材料、修回逐条回应。 |
设计原则
- 一个含
SKILL.md的目录就是一个可安装 skill；scripts、references 和 assets 与其共置。 - 每个 skill 自洽：不引用别的 skill，单独发给别人也能用。
- 每个 skill 保留精确的
description、自己的完成标准和单一事实来源。 - 只有具备独立触发或跨流程复用价值的纪律才拆成 skill；局部分支放进
references/。
仓库结构
skills/<name>/SKILL.md # 可安装 skills
evals/trigger_cases.json # 触发边界 golden cases
scripts/ # 仓库级校验工具
docs/skill-quality.md # 验收判据
docs/spec-conformance.md # 规范对齐情况
.claude-plugin/ # Claude Code marketplace 清单
plugin.json # Agent Plugins 包清单
skills/ 是 npx skills 官方支持的集合目录。CLI 会
发现其中每个包含 SKILL.md 的一级子目录。
维护
# 与 CI 相同的完整检查（装了 uv 就自动带齐依赖）
python3 scripts/ci.py
# 追加 scripts/ 的 branch coverage 门槛（最低 70%，需要 coverage 包）
python3 scripts/ci.py --coverage
# 官方安装器 discovery
npx skills@latest add . --list
GitHub Actions 会在 Python 3.11 与 3.13 上运行仓库测试和每个 skill 的内置测试，在 3.13
上强制 branch coverage 门槛，并单独验证官方 skills CLI 能发现全部 5 个 skills。
已安装的 skills 由 npx skills 管理。发布新提交后，运行 npx skills@latest update -g 更新全局安装。