Codex Skill 的核心价值是直接安装他人工作流实现一键生成会议纪要、查 TikTok 爆款商品等，安装需满足版本≥2.4.0、API 密钥配置正确、技能目录存在且含 SKILL.md 文件，并重启 Codex 才能生效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你想把别人写好的工作流直接装进 Codex 里用，不用自己从头写提示词、调工具、拼流程，比如一键生成会议纪要、自动查 TikTok 爆款商品、或者定制一只写实风桌面宠物——这正是 Codex Skill 的核心价值，安装对了，技能才能被识别、加载、触发。
确认前置环境已就绪
打开终端，执行 codex --version，确保输出版本号 ≥ 2.4.0；若报错或版本过低，先运行 npm install -g @openai/codex 升级 CLI。
检查 OpenAI API 密钥是否已配置：运行 echo $OPENAI_API_KEY，必须返回一串以 【sk-】 开头的密钥；为空则需执行 export OPENAI_API_KEY="你的密钥" 或使用 codex login 交互式授权。
默认 Skill 存放路径为 ~/.codex/skills/，该目录必须存在且有写入权限；若不存在，手动创建：mkdir -p ~/.codex/skills。
在线快捷安装（推荐新手）
方法一：在 Codex 交互终端内安装
启动 Codex：codex → 输入指令 $skill-installer → 等待列表加载完成 → 输入对应编号（如 【37】 安装 meeting-notes-and-actions）→ 回车确认。
方法二：用 GitHub 仓库地址直装
执行命令：python skill-installer/scripts/install-skill-from-github.py --repo ComposioHQ/awesome-codex-skills --path spreadsheet-helper；注意 【--path 后必须是仓库内子目录名，不是 GitHub 项目名】，填错会导致 SKILL.md 找不到而安装失败。
方法三：浏览器中拖拽安装
访问 tiktok-agent-skills 页面 → 点击绿色 Code 按钮 → Download ZIP → 解压后将整个文件夹拖入 ~/.codex/skills/ 目录 → 确保解压后文件夹内含 SKILL.md 文件。
通过本地 Codex 或 OpenClaw OAuth 凭证直接调用 ChatGPT/Codex Responses 的 image_generation 工具来生成或编辑光栅图像，然后保存
本地手动部署（适合调试或私有 Skill）
第一步：准备 Skill 目录结构
在 ~/.codex/skills/ 下新建文件夹，例如 my-custom-pet；进入该目录，创建 SKILL.md 文件，内容至少包含 name: 和 description: 两行元数据。
第二步：补全必要组件
若 Skill 需调用脚本，必须在目录下建 scripts/ 子目录，并把可执行文件（如 generate-report.py）放进去；Codex 只读取 SKILL.md 元数据来判断是否启用该 Skill，其余文件不校验但缺失会导致运行时报错。
第三步：验证目录完整性
运行 ls -R ~/.codex/skills/my-custom-pet/，确认输出中明确出现 SKILL.md；若只看到空目录或报 No such file，说明路径或文件名拼写错误，【文件名必须全大写、带英文句点、不可写成 skill.md 或 Skill.md】。
安装后必做动作
关闭当前 Codex 进程（包括后台服务），重新执行 codex 启动；未重启则新 Skill 不会被扫描加载，即使目录存在也始终不可用。
启动后，在对话中输入 list skills 或 show available skills，查看返回列表中是否包含你刚安装的 Skill 名称；若无，检查 ~/.codex/skills/ 下对应文件夹是否被 macOS 的隐藏规则屏蔽（如以 . 开头）、或 Windows 权限限制导致读取失败。
尝试触发测试：直接发送一句符合该 Skill 触发条件的指令，例如安装了 hatch-pet 就说“帮我生成一只基于这张猫照片的写实风桌面宠物”，观察 Codex 是否响应并开始执行流程。
