一键安装:用 skill-installer 快速装好 Codex 技能
2026/9/14 4:15:40 网站建设 项目流程

一键安装:用 skill-installer 快速装好 Codex 技能

【免费下载链接】awesome-codex-skillsA curated list of practical Codex skills for automating workflows across the Codex CLI and API.项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-codex-skills

想给 Codex 加个会议纪要技能,clone 完仓库还要手动翻目录、拷文件、重启服务,路径错一层就得重来。skill-installer 就是干这活的:一条命令列出可选的精选列表,一条命令把技能装进本地。

认识 skill-installer

skill-installer 是 awesome-codex-skills 仓库自带的安装器,帮你在一条命令内把散落在各仓库的 Codex 技能拉下来、放进~/.codex/skills,省掉手动 clone、找目录、拷文件的整个流程。

  • 📋技能发现:拉取精选列表,已装的技能自动标注
  • 🚀一键安装:从任意仓库路径把技能装进$CODEX_HOME/skills
  • 🔁方式回退:直接下载失败时自动切到Git 稀疏检出
  • 📦状态防护:目标目录已存在就中断,不会静默覆盖

本质上就是"下载、校验、落地"三步的 CLI 封装,两个脚本干完所有事:列技能用 skill-installer/scripts/list-curated-skills.py,装技能用 skill-installer/scripts/install-skill-from-github.py。

五分钟装好第一个技能

先把仓库克隆到本地。

git clone https://gitcode.com/GitHub_Trending/aw/awesome-codex-skills cd awesome-codex-skills

再用安装脚本装一个会议笔记技能到默认技能目录。

python3 skill-installer/scripts/install-skill-from-github.py \ --repo ComposioHQ/awesome-codex-skills \ --path meeting-notes-and-actions

装完记得重启 Codex,新技能的元数据才会被加载。执行后你会看到类似输出:

Installed meeting-notes-and-actions to /root/.codex/skills/meeting-notes-and-actions $ ls ~/.codex/skills meeting-notes-and-actions

拆解四个能力维度

下面按能力维度拆开看,命令都不长。

精选技能列表

不知道仓库里有哪些技能、自己已经装了哪些时,先列一遍再动手,能避开重复安装。

python3 skill-installer/scripts/list-curated-skills.py

列表来自 openai/skills 仓库的skills/.curated目录,走 API 拉取,网络受限时会直接报错退出。

安装方式与回退

公共仓库直接下载最快;私有仓库或下载接口被限流时,就得走 git。

触发命令:同"五分钟装好第一个技能"一节的安装命令,将--method参数改为git

git 回退会先试 HTTPS 再试 SSH,具体行为见 skill-installer/SKILL.md。

版本锁定

想装稳定版或开发版技能,而不是默认分支时,用--ref钉住版本。

python3 skill-installer/scripts/install-skill-from-github.py \ --repo <owner>/<repo> \ --path <skill-path> \ --ref <branch-or-tag>

不指定--ref时取仓库默认分支;分支名或标签写错会在拉取阶段直接报错。

批量安装与目录命名

一次要装多个技能,或者想把落地目录名改得更规范时,用多路径参数。

python3 skill-installer/scripts/install-skill-from-github.py \ --repo <owner>/<repo> \ --path <skill-a> <skill-b>

多路径安装按目录基名落地,--name仅对单技能安装生效;任一目标目录已存在,安装会直接中断,不会覆盖旧文件。

对比手动安装的差异

操作步骤手动方式用 skill-installer
取技能代码clone 整仓再逐层翻目录一条--path命令,只拉需要的技能
放入技能目录手动 cp 到~/.codex/skills自动落地$CODEX_HOME/skills/<name>
防重复安装自己 ls 检查,容易覆盖目录已存在直接报错中断
私有仓库配凭证 + 手写 sparse-checkout--method git自动回退并读取凭证

差异集中在"找位置"和"防翻车"两处:定位、校验、落地全由脚本代劳,手动环节从五六步压到一条命令。

用好容易忽略的配置方法

私有仓库凭证:技能放在公司私有仓库时,下载模式拿不到内容。

export GITHUB_TOKEN=<your-token>

效果:下载与 git 回退都会带上凭证,私有仓库可直接安装。

自定义技能目录:团队想共享同一套技能,或个人不想动默认目录时。

export CODEX_HOME=<your-codex-home>

效果:安装目标跟着变成<your-codex-home>/skills,无需每次传--dest

机器可读的列表:想在脚本里比对已装与未装技能时。

python3 skill-installer/scripts/list-curated-skills.py --format json

效果:每个技能带installed布尔值,方便接入自动化流程。

速查高频安装问题

现象大概率原因一行解法
装完技能 Codex 不识别新会话未加载元数据重启 Codex 后再试
下载报 HTTP 401/403私有仓库缺凭证export GITHUB_TOKEN=<your-token>后重跑安装
Destination already exists同名技能已装过追加--name <your-skill-name>换落地名
list 命令 404 报错.curated路径不存在或网络受限--repo <owner>/<repo>指向自建列表
沙箱里无网络脚本全程需要联网申请提升权限后重新运行

上次为装一个技能翻遍仓库目录的折腾到此为止:现在你跑一条命令就能把技能装进本地。下一步,先跑list-curated-skills.py看看当前可选的技能列表,再挑一两个装上试试。

【免费下载链接】awesome-codex-skillsA curated list of practical Codex skills for automating workflows across the Codex CLI and API.项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-codex-skills

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询