OpenAI 现在有官方的 Agent Skills 仓库,里面分 .system 和 .curated。我翻了一下,感觉比自己从零写 Skill 更适合入门:先看别人怎么拆任务边界,再改成自己的版本。
官方仓库:
- GitHub - openai/skills: Skills Catalog for Codex · GitHub
- Codex Skills 文档:Agent Skills – Codex | OpenAI Developers
我觉得优先看这几个
1. playwright
适合做浏览器自动化、截图、页面检查。前端开发时特别有用,因为它不只看代码,还能实际打开页面验证。
2. pdf
适合处理 PDF 读取、渲染、检查版式。比让模型直接“猜 PDF 内容”靠谱。
3. openai-docs
这个很适合学习“如何把官方文档查询流程写进 Skill”。当任务涉及更新很快的 API,Skill 应该强制查官方文档,而不是靠模型记忆。
4. gh-fix-ci / gh-address-comments
这类 GitHub 工作流技能值得看,因为它把“读失败日志、定位原因、修复、验证”的流程写得比较明确。
5. security-best-practices
安全类任务尤其适合做成 Skill,因为检查清单稳定,而且不能靠临场发挥。
安装方式
官方 README 里提到可以用 Codex 里的 $skill-installer 安装 curated skill,例如:
$skill-installer playwright
$skill-installer openai-docs
$skill-installer gh-fix-ci
装完后重启 Codex,让新技能被发现。
我学到的 Skill 设计原则
- 描述要写清楚“什么时候用”。
- 大文件放 references,不要全塞进 SKILL.md。
- 重复操作写 scripts,让模型调用脚本。
- 输出格式固定,减少每次漂移。
如果你准备自己写 Skill,建议先抄官方 skills 的目录结构,不要一开始就发明新范式。
1 个帖子 - 1 位参与者