codex技能安装需满足目录结构与核心文件双重条件，推荐用内置skill-installer一键安装；也可从github手动安装或离线压缩包部署，均须确保skill.md及配套文件完整置于指定路径。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你想让Codex具备生成PPT、自动写SQL、拉取会议纪要等专项能力，但点开界面找不到安装入口，也不清楚该把文件扔进哪个文件夹——这其实不是你配置错了，而是没走对安装路径。Codex的skill必须满足目录结构+核心文件双重条件才能被识别，缺一不可。
用内置技能安装器一键装（新手首选）
打开Codex终端（不是浏览器，是本地启动的CLI或VS Code插件内嵌终端），直接输入：
【$skill-installer】
回车后会弹出精选技能列表，用方向键选中目标skill（比如「ppt-maker」），按回车确认安装。
默认装到用户全局目录 ~/.codex/skills/，所有项目都能调用；加 --local 参数可限定在当前项目生效：$skill-installer --local
安装完成后，必须新开一个对话窗口，旧窗口不会自动加载新skill。
从GitHub仓库手动安装（适合私有技能或调试）
方法一：用脚本自动拉取并解包
执行命令（以安装 ComposioHQ 的 meeting-notes-and-actions 为例）：
通过本地 Codex 或 OpenClaw OAuth 凭证直接调用 ChatGPT/Codex Responses 的 image_generation 工具来生成或编辑光栅图像，然后保存
python skill-installer/scripts/install-skill-from-github.py --repo ComposioHQ/awesome-codex-skills --path skills/meeting-notes-and-actions
该命令会自动创建目录、校验SKILL.md、处理依赖，比纯手动更稳妥。
方法二：手动克隆+挪动文件
先克隆整个仓库：git clone https://github.com/xxx/xxx-skill.git ~/temp-skill
再确保目标路径下存在 SKILL.md 文件，把它连同所有相关文件一起移入：
macOS： mv ~/temp-skill/skills/your-skill-name ~/.codex/skills/
Windows： move C:\Users\用户名\temp-skill\skills\your-skill-name C:\Users\用户名\.codex\skills\
⚠️ 注意：不能只复制SKILL.md，配套的main.py、manifest.json等文件必须同级存在，否则运行时报错“skill definition invalid”。
离线压缩包安装（无网络环境或内网部署）
第一步：解压zip包到临时目录
第二步：检查解压后文件夹内是否含 SKILL.md ——这是Codex识别skill的唯一硬性门槛，没有它就不是合法skill
第三步：将整个skill文件夹（不是里面的内容）复制到对应路径：
项目级：你的项目根目录 → .codex/skills/技能名
用户级： ~/.codex/skills/技能名（macOS/Linux）或 C:\Users\用户名\.codex\skills\技能名（Windows）
第四步：重启Codex客户端或在新对话中输入 /技能名 tab 触发自动补全，出现提示即表示安装成功
