企业官网建设流程全解析

如何用 $skill-installer 在 Codex 中列出并安装 curated 与 experimental skill

【免费下载链接】skillsSkills Catalog for Codex项目地址: https://gitcode.com/GitHub_Trending/skills4/skills

skills 仓库（Skills Catalog for Codex）把一批可复用的 Agent Skill 按目录分类存放：.system目录下的 skill（包括skill-installer本身）会随最新版 Codex 自动安装，不需要手动操作；而.curated（精选）和.experimental（实验）两类 skill 需要通过 Codex 内置的$skill-installer来列出和安装。这篇文章围绕这条路径展开：先看有哪些 skill 可用，再分别用名字安装 curated skill、用目录描述或 GitHub 地址安装 experimental skill，最后确认安装结果并让 Codex 生效。

开始之前需要注意两点：

• 仓库 README 顶部提示：该仓库已弃用（deprecated），当前 Codex skill 与插件示例请以 OpenAI Plugins 仓库为准。如果你要长期维护自己的 skill，按官方插件指南操作；本文只针对现有目录中的 skill 完成列出与安装这一任务。
• $skill-installer位于 .system/skill-installer，属于自动预装的 system skill，你不需要单独安装它，直接在 Codex 会话中以$skill-installer开头发起即可。它依赖 scripts/list-skills.py 和 scripts/install-skill-from-github.py 两个脚本完成实际工作，两个脚本都会访问网络，在沙箱中运行时脚本会请求提权（escalation）。

列出可用的 skill：curated 与 experimental 两个目录

在 Codex 中直接要求列出 skill，例如：

$skill-installer list the available skills

skill-installer的默认列表就是skills/.curated。如果你要的是实验目录，明确要求它改查.experimental，底层对应参数是--path skills/.experimental：

$skill-installer list the experimental skills

列表输出按 SKILL.md 的说明大致如下（文档示例）：

Skills from {repo}: 1. skill-1 2. skill-2 (already installed) 3. ... Which ones would you like installed?

其中(already installed)注解来自本地$CODEX_HOME/skills（默认为~/.codex/skills）中已存在的目录名，可以直接用它判断哪些还没装。列表默认取自 GitHub 仓库路径skills/.curated，list-skills.py还支持--format json（输出{"name": ..., "installed": ...}数组）以及--repo、--ref参数（ref 默认main），方便脚本化核对。

两点边界：curated 列表通过 GitHub API 拉取，API 不可用时脚本会报错退出，此时按报错信息处理即可；如果传错路径，脚本会以Skills path not found: ...形式提示对应的 GitHub 目录地址，可据此核对--path是否写对。

安装 curated skill：直接给 skill 名字

curated skill 可以按名字安装，名字对应.curated下的目录名，例如 README 给出的例子：

$skill-installer gh-address-comments

skill-installer会把该 skill 从 curated 列表安装到本地。需要装多个、或想显式指定来源仓库时，底层脚本的调用形式为（来自 SKILL.md 的 Scripts 一节）：

scripts/install-skill-from-github.py --repo <owner>/<repo> --path <path/to/skill> [<path/to/skill> ...]

常用选项：

• --url https://github.com/<owner>/<repo>/tree/<ref>/<path>：用 GitHub 目录地址代替--repo+--path；
• 多个--path可以在一次运行中安装多个 skill，每个 skill 以路径 basename 命名，除非提供--name；
• --ref <ref>指定分支/标签，默认main；
• --dest <path>指定安装目标目录，默认$CODEX_HOME/skills；
• --method auto|download|git控制获取方式，默认auto：优先直接下载仓库 zip，若出现 401/403/404 等认证或权限错误则回退到 git sparse checkout（先 HTTPS，再 SSH）。

私有仓库可以通过已有的 git 凭据访问，下载方式也可以配置GITHUB_TOKEN/GH_TOKEN。

安装 experimental skill：给目录描述或 GitHub 地址

experimental skill 不能只给名字，需要指明它所在的目录。README 给出两种写法：

$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.md）：

scripts/install-skill-from-github.py --repo openai/skills --path skills/.experimental/<skill-name>

这里的<skill-name>替换为.experimental目录下实际的 skill 目录名，可以先用上一节的 experimental 列表确认。

确认安装结果并让 Codex 生效

安装完成的判断依据有两条，都来自文档本身：

1. 脚本成功时会为每个 skill 打印一行，形如Installed <skill-name> to <dest-dir>（install-skill-from-github.py 的输出格式），其中<dest-dir>即$CODEX_HOME/skills/<skill-name>。
2. 再运行一次列表（$skill-installer list the available skills，或scripts/list-skills.py），刚安装的 skill 后面会带(already installed)注解；JSON 格式下对应条目为"installed": true。

关于生效时间，文档中两处表述略有不同，按 README 的要求执行即可：安装完成后重启 Codex以加载新 skill。而 SKILL.md 的 Communication 一节则说明安装后会提示用户“下一个 turn 即可用”。如果你重启后某个 skill 仍不可用，先按下面一节检查安装是否真正落盘。

安装失败的常见原因

根据 install-skill-from-github.py 的实现与 SKILL.md 的说明，失败会以Error: ...形式打印到 stderr，常见情形：

• Destination already exists: ...—— 目标 skill 目录已存在，脚本会中止而不会覆盖。此时需要你先自行处理掉已有的同名目录再重跑，脚本本身不会替你删除。
• SKILL.md not found in selected skill directory./Skill path not found: ...—— 路径不对，skill 目录内必须包含SKILL.md。回上一节的列表核对目录名与--path。
• Download failed: HTTP 4xx—— 直接下载失败；--method auto会尝试 git 回退，仍失败时多为凭据问题（私有仓库），按上文配置GITHUB_TOKEN/GH_TOKEN或 git 凭据。
• 脚本会校验 skill 名称必须是单级路径段，--path必须是仓库内的相对路径，写绝对路径或../开头的路径会直接报错。

小结与边界

整个任务可以收敛为一条连续路径：在 Codex 里用$skill-installer先列出.curated（默认）或.experimental（要求改查该目录）的 skill，按名字安装 curated skill、按目录描述或 GitHub 地址安装 experimental skill，用“目录注解 + 安装输出”核对结果，然后重启 Codex 生效。

最后重申一个范围边界：.system目录下的 skill 是预装的，skill-installer不会帮你重复安装它们；本仓库已标记弃用，新 skill 的开发与发布请参考官方插件指南。

【免费下载链接】skillsSkills Catalog for Codex项目地址: https://gitcode.com/GitHub_Trending/skills4/skills