如何快速安装 Codex 技能：skill-installer 完整使用指南
【免费下载链接】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 装个技能还不想手动克隆仓库、拷文件？skill-installer 把发现、安装、去重压缩成两三条命令。全文覆盖从列表到安装的完整流程与参数细节。
📋 前置条件
- 有 Python 3 环境（脚本仅用标准库，无需 pip 安装）
- 有 git（回退通道依赖它）
- 网络可访问 GitHub（列表与安装都拉取远端内容）
- 私有仓库需要 GitHub token（export GITHUB_TOKEN）或已有 git 凭据
🚀 核心工作流
git clone https://gitcode.com/GitHub_Trending/aw/awesome-codex-skills && cd awesome-codex-skills拿到仓库代码，两个脚本都在 skill-installer/scripts/ 下。
python skill-installer/scripts/list-curated-skills.py逐行列出精选技能，本地已装的会标注 (already installed)。
python skill-installer/scripts/install-skill-from-github.py --repo ComposioHQ/awesome-codex-skills --path meeting-notes-and-actions技能落盘到 $CODEX_HOME/skills（默认 ~/.codex/skills），装完重启 Codex 生效。
📊 参数与行为对照
| 参数 | 作用 | 示例值 |
|---|---|---|
--repo | 安装来源仓库，owner/repo 格式 | ComposioHQ/awesome-codex-skills |
--path | 仓库内技能路径，可传多个批量装 | meeting-notes-and-actions |
--url | 直接传技能页面 URL 安装 | https://github.com/owner/repo/tree/<ref>/<path> |
--ref | 指定分支或标签，默认仓库默认分支 | v1.0.0 |
--method | auto 自动选、download 直连、git 走稀疏检出 | git |
--dest | 安装目录，默认 $CODEX_HOME/skills | /path/to/skills |
--name | 自定义技能目录名，默认取路径末段 | my-skill |
--format（列表脚本） | 输出 text 或 json | json |
GITHUB_TOKEN | 私有仓库下载 token（环境变量） | export GITHUB_TOKEN=<token> |
不加--method时默认 auto，公共仓库先走直接下载。遇到 401/403/404 自动回退 git 稀疏检出（只取需要的目录）。目标目录已存在时直接中止，防止覆盖。逐项细节可对照 SKILL.md。
🎬 实战场景
一次装多个基础技能
多个--path等价于批量安装，目录名取各自路径末段。
python skill-installer/scripts/install-skill-from-github.py --repo ComposioHQ/awesome-codex-skills --path meeting-notes-and-actions codebase-migrate内网装私有仓库
私有仓库没法直接下载，先导出 token 再显式走 git 方式。
export GITHUB_TOKEN=<你的token> python skill-installer/scripts/install-skill-from-github.py --repo your-company/internal-skills --path internal-tools/integration-tester --method git用 --ref 锁定版本
装稳定 tag 或开发分支，只加--ref。
python skill-installer/scripts/install-skill-from-github.py --repo owner/repo --path skill-name --ref v1.0.0🛠 常见问题速查
- 直接下载报权限/鉴权错误→ 加
--method git换稀疏检出通道。 - 装完技能不生效→ 重启 Codex，安装结束时的提示语就是这一步。
- 精选列表拉取失败（GitHub API 不可达）→ 跳过列表，用
--url传页面链接直接装。 - 提示目标目录已存在→ 防重名中止，
--name换名或--dest换目录后重试。 - URL 安装报不支持→
--url只解析 github.com 链接，改用--repo+--path组合。
列表脚本加--format json跑一遍，把清单喂给自己的脚本批量处理。
【免费下载链接】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），仅供参考
