awesome-codex-skills

环境要求

• 已安装 Git
• 已安装 Python（用于运行 skill-installer 脚本）
• 已安装并配置 Codex CLI（技能需被 Codex 加载）
• 可选：设置 CODEX_HOME 环境变量（未设置时默认为 ~/.codex）

安装与启动步骤

1. 1克隆仓库

   把 awesome-codex-skills 仓库下载到本地，后续从本地目录读取技能定义与安装脚本。

   git clone https://github.com/ComposioHQ/awesome-codex-skills.git

   复制

2. 2进入项目目录

   切换到刚克隆下来的仓库根目录，安装脚本的相对路径基于此目录。

   cd awesome-codex-skills

   复制

3. 3用安装器安装技能

   官方推荐的安装方式，把指定技能抓取并放入 $CODEX_HOME/skills/<skill-name>，未设置时默认 ~/.codex/skills。

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

   复制

4. 4安装其他技能

   把 --path 换成仓库中其他技能目录名，可重复执行安装一个或多个技能。

   python skill-installer/scripts/install-skill-from-github.py --repo ComposioHQ/awesome-codex-skills --path spreadsheet-formula-helper

   复制

5. 5重启 Codex

   安装完成后必须重启 Codex，让它重新加载新技能的元数据。

6. 6手动安装（可选）

   不用脚本时，把需要的技能文件夹（如 ./spreadsheet-formula-helper）复制到 $CODEX_HOME/skills/，再重启 Codex。

   cp -r ./spreadsheet-formula-helper "$CODEX_HOME/skills/"

   复制

关键配置

如何确认成功

检查 $CODEX_HOME/skills/（默认 ~/.codex/skills/）下出现对应技能目录，重启 Codex 后新会话中提及任务或技能名能被触发。

常见问题

注意事项

• 安装目标目录由 $CODEX_HOME 决定，默认是 ~/.codex/skills，安装前先确认该目录可写。
• --repo 与 --path 参数需指向实际的仓库名和技能目录名，路径写错会导致安装失败。
• 手动安装时复制的是整个技能文件夹，不是单个文件，且复制后同样需要重启 Codex。