📌 项目地址：openai/skills | ⭐ 20,794 颗星 | 🔧 Python | 📜 未标注
先说结论：这个仓库已经废弃了
openai/skills，20794 颗星，README 第一行就是废弃声明。所有 Codex 的 skill 和 plugin 示例已迁移到 openai/plugins，自己写 skill 的人应该看 Build plugins 指南。
所以这篇文章不是安装教程。如果你今天就要动手做东西，直接去新仓库。这里想讲的是另一件事：这个废弃仓库里有一套值得看的设计思路，而且它的死亡方式本身也有信息量。
Agent Skills 到底是什么
官方定义：Agent Skills 是包含指令、脚本和资源的文件夹，AI 代理可以自己发现并使用它们来执行特定任务。口号是”写一次，到处用”。
我第一次读到这个定义时，注意点是”文件夹”这三个字。没有编译，没有包管理器，没有运行时依赖。一个 skill 就是一个目录，里面是 Markdown 写的操作说明、可执行的脚本、参考资源。把目录拷过去，它就存在了。
关键机制在”发现”这个词上。skill 不是人手动挂载到对话里的，而是 Codex 在任务执行过程中自己搜索可用技能，自己判断哪个适用、什么时候触发。这更像给新员工一本操作手册放在文件柜里——他用不用、什么时候用，取决于任务本身。
对团队的直接好处：把一套流程（比如”怎么处理 GitHub PR 里的地址评论”）封装进文件夹，之后任何项目、任何人都能复用，不用每次给 AI 重新解释一遍。
三层目录，对应三种信任级别
仓库的 skills 目录分三层，安装方式各不相同：
.system/ — 自动装进最新版 Codex，用户不用操作。
.curated/ — 精选 skill，按名称安装，默认从这个目录取：
$skill-installer gh-address-comments
.experimental/ — 实验 skill，需要显式指定来源。可以用自然语言：
$skill-installer install the create-plan skill from the .experimental folder
也可以直接给 GitHub 目录 URL：
$skill-installer install https://github.com/openai/skills/tree/main/skills/.experimental/create-plan
安装命令本身是个值得看的细节。$skill-installer 接受自然语言参数——“install the create-plan skill from the .experimental folder”这句话能直接执行。命令行接口和自然语言接口在这里合并了。
还有一个容易漏掉的点：装完必须重启 Codex，新 skill 才生效。README 明确写了。
授权也是分散的。每个 skill 目录里有自己的 LICENSE.txt，按单个 skill 独立授权，不是整仓库一份协议。这个设计明显是为分发和组合准备的——你可以只取一个 skill 塞进自己的体系，不用背走整个仓库的授权条款。
为什么停更：skill 被收编进 plugin 体系
README 没解释废弃原因，但线索都在。新的自定义教程指向 Build plugins 指南，里面有一节专门讲怎么做”skill-only plugin”——纯 skill 的插件。
也就是说，skill 从一个独立概念变成了 plugin 的子类型。原来的”skill 仓库”变成了“plugin 仓库的一个分区”。这是常见的架构收敛：能力封装的粒度从单一形态（文件夹）扩展成一个更通用的容器（plugin），skill 降级为容器里的一种内容。
另一个背景是 agentskills.io，Agent Skills 的开放标准站点。这套规范不是 OpenAI 独有，其他厂商的代理也在跟进。仓库死了，标准还活着。
这个仓库还值不值得翻
分两种情况。
想动手做东西的人：别在这里花时间。去 openai/plugins 和 Build plugins 指南，那边是活的方向，API 和目录结构都可能有变化。
想理解设计思路的人：可以翻。这里完整保留了一批官方 skill 的实现，是现成的参考样本——怎么写 skill 的说明文档、怎么组织脚本和资源、怎么定义触发条件。内容不再更新，但作为快照是完整的。而且每个 skill 的 LICENSE.txt 也方便你合法地借用具体写法。
两万星反映的不是代码质量（这个仓库的主体是 Markdown 和脚本），而是它定义的封装方式踩中了真实需求：把任务能力做成可插拔的文件夹，让模型自己判断使用时机。这个思路没有跟着仓库一起沉寂，它换了个名字继续往前走。