一键安装:用 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),仅供参考