企业官网建设流程全解析

如何一键安装 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 装个技能，得手动克隆仓库、翻目录、再拷文件进~/.codex/skills。awesome-codex-skills 里的 skill-installer 把"浏览 → 安装 → 防重名"这三步压缩成两三条命令。下面按 能力一览 → 跑通全流程 → 参数与场景 → 排障手册 的顺序展开。

🧭 能力一览：skill-installer 装什么、怎么装

skill-installer 是仓库内置的 Codex 技能安装器：list-curated-skills.py拉取 OpenAI 维护的精选技能清单并标注本地安装状态，install-skill-from-github.py负责把技能落盘到$CODEX_HOME/skills（默认~/.codex/skills）。两个脚本位于 skill-installer/scripts/，行为细节可在 SKILL.md 里对照。

运行list-curated-skills.py后的示例输出：

1. meeting-notes-and-actions
2. spreadsheet-formula-helper (already installed) Which ones would you like installed?

已装技能会带 "(already installed)" 标注，避免重复安装。

🚀 跑通全流程：克隆、列清单到验证生效

这一节带你用最短路径装好第一个技能。环境要求只有一条：本机装了 Python（脚本仅依赖标准库），无需 pip 安装第三方包。

# 克隆技能仓库并进入目录 git clone https://gitcode.com/GitHub_Trending/aw/awesome-codex-skills cd awesome-codex-skills # 查看精选技能清单，已安装的会带标注 python skill-installer/scripts/list-curated-skills.py

确认要装的名字后执行安装：

# 把指定技能安装进 $CODEX_HOME/skills python skill-installer/scripts/install-skill-from-github.py \ --repo ComposioHQ/awesome-codex-skills \ --path meeting-notes-and-actions

成功后脚本打印Installed meeting-notes-and-actions to /path/to/skills/meeting-notes-and-actions。重启 Codex，新技能即生效。

⚙️ 参数与进阶选项：skill-installer 安装参数速查

这张表汇总两个脚本的全部可选项，覆盖来源、分支、位置三类配置。

推荐的推进节奏：先跑列表浏览描述，在测试机装好并验证触发，再部署到日常生产环境。

🎬 场景演练：从单个技能到私有仓库接入

批量安装常用技能

初用 Codex 时通常一次装好几个。多个--path等价于批量安装，目录名取各自路径的末段：

# 一次安装两个技能 python skill-installer/scripts/install-skill-from-github.py \ --repo ComposioHQ/awesome-codex-skills \ --path meeting-notes-and-actions codebase-migrate

如果手里只有技能所在页面的链接，可以把--repo和--path换成--url直接传入，解析出的路径自动生效。

固定版本安装

给生产环境装稳定版，用--ref钉住标签，避免默认分支后续更新带来意外变化：

# 从 v1.0.0 标签安装固定版本 python skill-installer/scripts/install-skill-from-github.py \ --repo owner/repo \ --path skill-name \ --ref v1.0.0

私有仓库接入

私有仓库走下载通道容易失败，先导出 token，再显式指定 git 方式：

# 私有仓库用 git 稀疏检出方式安装 export GITHUB_TOKEN=your_github_token python skill-installer/scripts/install-skill-from-github.py \ --repo your-company/internal-skills \ --path internal-tools/integration-tester \ --method git

git 方式会先试 HTTPS 再回退 SSH；GH_TOKEN与GITHUB_TOKEN任一即可，脚本会自动带进请求头。

🛠 排障手册：高频症状到处理命令

动手前先做三项检查：

• 确认目标技能目录不存在，脚本检测到重名会直接中止，防止覆盖已有技能
• 确认对目标仓库有访问权限，私有仓库需先备好 token
• 生产环境先备份$CODEX_HOME/skills下的现有技能

高频故障按"症状 → 处理"对照：

• 直接下载报 401/403 权限错误 → 加--method git换稀疏检出通道
• 装完技能不生效 → 重启 Codex，安装提示里的 "Restart Codex to pick up new skills" 就是这一步
• 列表脚本拉取失败（GitHub API 不可达）→ 跳过列表环节，用--url传页面链接直接安装
• 提示Destination already exists→ 属于防重名中止，用--name换目录名或--dest换安装位置后重试

下一步

跑通后，按 README 里的技能分类（开发与代码工具、生产力与协作、数据与分析等）把团队常用技能批量补齐，并用--ref给生产环境固化版本。装完任何一个技能，重启 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