必须安装对应skill才能让codex自动完成pdf处理、github pr审查等任务,否则会缺步骤、漏文件、权限报错;需先选定工作区、设为默认权限,再通过克隆仓库、手动放入或cli三种方式安装,最后用/skills和$指令验证。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

想让 Codex 自动完成 PDF 处理、GitHub PR 审查或截图生成这类重复性任务,必须装上对应的 Skill,否则它只会用通用方式硬凑,结果往往缺步骤、漏文件、权限报错。
确认 Codex 已就位并选好工作区
打开 Codex App,点击左侧「项目」→ 选择一个干净的本地文件夹(比如 ~/codex-skills-demo),【这一步不可跳过,没选工作区,Skill 安装后无法加载】。右下角出现“已信任该工作区”提示后,再进行后续操作。
确保对话框底部权限模式设为「默认权限」——自动审查或完全访问权限会导致 Skill 执行中断或静默失败。
安装 Skill 的三种方式
方法一:从官方 Skills 仓库一键克隆(推荐新手)
打开终端,进入你刚选定的工作区目录 → 运行:git clone https://github.com/openai/codex-skills.git skills → 等待下载完成。Codex 会自动识别 skills/ 文件夹下的所有 Skill,无需手动启用。
方法二:手动放入 Skill 文件夹(适合调试单个 Skill)
在工作区根目录新建文件夹 skills/my-pdf-tool → 把含 SKILL.md 的完整 Skill 文件夹拖入其中 → 重启 Codex App 或输入 /skills reload 刷新列表。
方法三:用 CLI 安装公开插件(仅限已打包发布的 Skill)
运行 codex plugin install pdf-skill → 输入 y 确认 → 安装成功后会在 ~/.codex/plugins/ 下生成对应目录,但注意:【CLI 安装的 Skill 默认不启用,需手动在设置 → 插件中勾选】。
验证 Skill 是否生效
第一步:在对话框输入 /skills → 查看返回列表中是否出现你安装的 Skill 名称(如 pdf-merge 或 github-pr-review);
第二步:输入 $pdf-merge → 观察 Codex 是否立刻加载描述并等待你提供 PDF 文件路径;
第三步:若提示 “未找到匹配 Skill”,检查 skills/ 文件夹是否在工作区根目录下,且内部每个子文件夹都包含有效的 SKILL.md(首行必须有 YAML frontmatter,含 name: 和 description:)。
这一步操作起来很简单,直接把文件拖进去就行。











