GPT Home

Appearance

作者：GPT Home发布：更新：编辑与更新规范

Codex Skills怎么安装？国内Codex技能配置、SKILL.md与常用Skills教程（2026） ​

最后更新：2026 年 7 月 26 日。Codex Skills 的安装入口、目录和界面可能随 Codex App、CLI 或插件版本调整。本文依据当前 Codex 内置 Skill Installer、Skill Creator 和本机目录结构整理，实际操作请以你当前版本显示为准。

Codex Skill 是一个包含 SKILL.md 的独立目录，用来教 Codex 按固定流程完成某类任务，例如 SEO 审核、营销文案、图片生成、PDF 处理或项目发布。它不是传统的模型插件，也不是随便复制一段提示词；一个完整 Skill 还可以携带脚本、参考资料和模板资源。

国内开发者先确认Codex连接

如果 Codex 已经能正常运行，可以直接继续安装 Skills。需要 ChatGPT Pro、Codex 连接和可选开发额度，可以查看 zeogpt.com。

zeogpt 是第三方服务，不是 OpenAI 官网。具体连接方式、套餐、额度、价格和有效期以平台实时页面为准。

Codex国内版模型与开发界面示意

一、Codex Skills是什么？ ​

Skills 是可复用的专业工作流。它帮助 Codex 在遇到特定任务时加载对应说明，而不是每次都让用户从头描述所有步骤。

一个 Skill 通常可以提供：

  1. 专业流程：例如从 Bing 调研到 SEO 文章发布；
  2. 工具使用：例如如何处理 PDF、表格或图片；
  3. 领域知识：例如公司的数据结构、内容规范和发布规则；
  4. 自动化脚本：减少重复编写容易出错的命令；
  5. 参考资料：只在任务需要时加载更详细的信息；
  6. 模板与素材：生成文章、报告或页面时复用。

Skill和普通提示词有什么区别？ ​

对比项普通提示词Codex Skill
使用范围当前一次对话或任务可在后续相似任务中重复触发
保存位置聊天记录独立 Skill 目录
核心文件无固定格式必须有 SKILL.md
可带脚本通常不能直接复用可以放入 scripts/
可带资料需要每次粘贴可以放入 references/
适合场景临时要求稳定、重复、专业的工作流

Skill和AGENTS.md有什么区别？ ​

  • AGENTS.md：描述某个仓库长期适用的项目规则，例如构建命令、代码风格和禁止事项；
  • Skill：描述跨项目可复用的任务方法，例如“如何做 SEO 审核”或“如何生成并验证 Word 文档”；
  • 当前提示词：只约束这一次具体任务。

项目规则放 AGENTS.md，专业流程做成 Skill，临时目标留在当前任务里，通常最清楚。

二、Codex Skill目录结构是什么？ ​

最小可用结构只有一个目录和一个 SKILL.md：

text
my-skill/
└── SKILL.md

功能完整的 Skill 可以这样组织：

text
my-skill/
├── SKILL.md
├── agents/
│   └── openai.yaml
├── scripts/
│   └── run-check.py
├── references/
│   └── workflow.md
└── assets/
    └── template.md
文件或目录作用
SKILL.md必需；写名称、触发描述和核心工作流
agents/openai.yaml推荐；用于 Skill 列表中的显示名称和默认提示
scripts/可选；放确定性脚本和重复命令
references/可选；放详细文档、规则、API或领域资料
assets/可选；放模板、图标、字体和输出素材

不要为了“看起来完整”创建大量空目录。只有任务真正需要脚本、资料或模板时再添加。

三、SKILL.md怎么写？ ​

SKILL.md 至少需要 YAML frontmatter 中的 name 和 description，然后在正文写工作流程。

markdown
---
name: vitepress-seo-publisher
description: 为 VitePress 中文博客写作、更新栏目、构建并检查 canonical、Schema 与 sitemap。用户要求写 SEO 文章或发布内容时使用。
---

# VitePress SEO Publisher

1. 先检查已有标题，避免关键词自相残杀。
2. 新文章必须包含 date、updated、author 和 description。
3. 更新专题页和侧栏，避免孤立页面。
4. 运行 npm run build。
5. 检查生成 HTML、canonical、BlogPosting 和 sitemap。

name应该怎么写？ ​

  • 使用小写字母、数字和连字符；
  • 名称尽量短，能表达动作或领域；
  • 目录名应与 Skill 名称一致；
  • 不要使用空格和含义模糊的名称。

description为什么重要？ ​

Codex 主要根据 name 和 description 判断什么时候加载 Skill。描述应同时说明：

  • 这个 Skill 能做什么；
  • 用户说什么或遇到什么任务时应该使用；
  • 不适用的边界是什么。

如果只写“一个很强的 SEO Skill”，Codex 很难判断触发时机。写成“用户要求 SEO 审核、技术 SEO、Schema 或排名诊断时使用”会更明确。

四、Codex Skills怎么安装？ ​

当前 Codex 提供内置 Skill Installer 工作流，可以安装官方整理的 Skills，也可以从 GitHub 仓库路径安装。不同 Codex 版本可能通过技能面板、自然语言指令或安装器完成，不要把网上出现的某条命令当作所有版本都支持的统一 CLI 命令。

方法一：让Codex列出可安装Skills ​

可以直接对 Codex 说：

text
列出当前可以安装的 curated skills，并标记已经安装的项目。

如果想看实验性 Skills：

text
列出 experimental skills，先不要安装。

选择前先看 Skill 名称、描述和来源，不要一次安装大量与工作无关的项目。

方法二：安装官方整理的Skill ​

例如：

text
请安装 imagegen skill。完成后告诉我它会从什么时候开始可用。

内置安装器默认从 OpenAI Skills 仓库的 curated 或 experimental 路径读取。系统级 Skills 通常已经随 Codex 提供，不需要重复安装。

安装完成后，新 Skill 一般从后续任务或下一轮对话开始可用。若未出现，可重新打开任务或按当前 Codex 版本提示刷新。

方法三：从GitHub URL安装 ​

当作者提供完整 GitHub 目录链接时，可以让 Codex 安装：

text
请从这个 GitHub URL 安装 Skill：
https://github.com/OWNER/REPO/tree/main/path/to/my-skill

也可以提供仓库与路径：

text
请从 OWNER/REPO 的 path/to/my-skill 安装这个 Skill。

内置安装器会把 Skill 安装到 $CODEX_HOME/skills/<skill-name>。Windows 默认通常对应：

text
C:\Users\你的用户名\.codex\skills\<skill-name>

macOS 和 Linux 通常对应：

text
~/.codex/skills/<skill-name>

方法四：安装私有GitHub仓库中的Skill ​

私有仓库需要当前环境已配置 Git 凭据，或提供适用的 GITHUB_TOKEN / GH_TOKEN。不要把 Token 粘贴进公开文章、截图、仓库或普通聊天记录。

安装器可能先尝试直接下载，权限失败时再使用 Git sparse checkout。遇到 401 或 403，应先检查仓库权限和凭据，不要反复创建新 Token。

五、能不能手动安装Codex Skill？ ​

可以，但更适合清楚目录结构的用户。基本步骤是：

  1. 获取完整 Skill 目录；
  2. 确认根目录存在 SKILL.md；
  3. 检查 SKILL.md 的 name 和 description；
  4. 把整个目录放入 $CODEX_HOME/skills/；
  5. 重新开始一个任务，确认 Skill 能被识别。

不要只复制 SKILL.md，却遗漏它引用的脚本、资料或模板。也不要把多个 Skill 的文件混在同一个目录中。

安装前先做安全检查 ​

重点检查：

  • scripts/ 是否包含删除、上传或网络请求操作；
  • 是否要求读取 .env、SSH Key、浏览器 Cookie 或生产凭据；
  • 是否会修改全局配置、安装软件或执行管理员命令；
  • GitHub 仓库作者、提交记录和许可证是否可信；
  • Skill 描述是否与实际脚本行为一致。

Skill 是工作流，不是安全豁免。脚本仍然可能修改文件或调用网络，安装来源不明的 Skill 前必须审查。

六、如何创建自己的Codex Skill？ ​

当一套任务已经重复三次以上，并且每次都要重新解释相同规则，就值得做成 Skill。

第一步：明确触发场景 ​

例如你经常说：

text
先去 Bing 研究标题，再写一篇 VitePress SEO 文章，推荐三个产品，更新专栏和侧栏，最后 npm run build。

这就是适合 Skill 的重复工作流。

第二步：决定是否需要资源目录 ​

  • 只有步骤和规则：只写 SKILL.md；
  • 经常运行相同检测：增加 scripts/；
  • 有较长产品资料和写作标准：增加 references/；
  • 有固定文章模板、图片或文件：增加 assets/。

第三步：初始化Skill ​

Codex 的 Skill Creator 提供初始化和验证脚本。不同安装环境的脚本路径会不同，最简单的做法是直接告诉 Codex：

text
帮我创建一个名为 vitepress-seo-publisher 的个人 Skill，放到默认 skills 目录。
需要 scripts 和 references，但不要创建无用文件。

创建后检查 SKILL.md、界面元数据和实际资源是否一致。

第四步：用真实任务验证 ​

不要只检查 Markdown 格式。用一个真实的小任务测试：

  • Skill 是否在正确场景触发；
  • 是否读取了需要的参考资料；
  • 是否运行了正确脚本；
  • 是否越过了任务边界；
  • 是否完成了构建或验证；
  • 输出是否比没有 Skill 时更稳定。

七、国内用户推荐安装哪些Codex Skills？ ​

不要按数量安装，按实际工作选择。

工作场景Skill方向能解决什么问题
SEO站长SEO audit、content strategy、schema排名诊断、选题、结构化数据和内容规划
博客写作copywriting、copy editing写新页面、提升转化、刷新旧内容
图片创作image generation生成文章配图、封面、商品图和视觉素材
Word/PDF办公documents、PDF创建、编辑、渲染和检查文档
数据分析spreadsheets分析 CSV/XLSX、生成公式和图表
演示汇报presentations创建和修改 PPT
自动化发布自定义发布Skill更新导航、构建、检查 sitemap 和提交索引

安装三个真正会用的 Skills，通常比安装三十个更有效。Skills 太多时，名称和描述重叠也可能让触发逻辑变得模糊。

八、Codex Skills安装后怎么使用？ ​

多数情况下不需要每次写出完整 Skill 名称，只要任务与 description 匹配，Codex 就可以加载对应 Skill。

也可以明确指定：

text
使用 marketing-copywriting 和 marketing-seo-audit，先审核现有页面，再重写首屏和 CTA。

一个SEO站长的实际示例 ​

text
使用内容策略、SEO审核和文案Skill：
1. 先检查站内是否已有同意图文章；
2. 调研 Bing 当前标题和联想词；
3. 保留已有高价值URL；
4. 写完后更新专题页和侧栏；
5. 运行npm run build；
6. 检查canonical、BlogPosting和sitemap。

Skill 负责专业流程，当前提示词负责今天具体要改哪一篇文章。两者结合，比让 Skill 猜测全部目标更可靠。

九、Codex Skills安装失败怎么办？ ​

现象常见原因处理方法
找不到Skill目录放错、缺少 SKILL.md 或安装后未刷新检查 $CODEX_HOME/skills/<name>/SKILL.md，新开任务测试
GitHub下载失败网络超时、URL错误或仓库权限不足核对仓库与路径，检查 Git 凭据或 Token
提示目标目录已存在同名Skill已经安装先检查现有版本，不要直接覆盖自定义修改
安装后不触发description过于模糊或任务不匹配重写触发描述，明确使用场景
脚本执行失败Python/Node依赖缺失或路径不兼容单独运行脚本并检查环境
读取了错误资料references层级太深或说明不清从 SKILL.md 直接链接必要资料
每次加载内容太多SKILL.md 过长保留核心流程，把细节移到 references

为什么不要随便覆盖同名Skill？ ​

安装器通常会在目标目录已存在时停止，这是为了保护本地改动。正确做法是比较现有 Skill 与新版本，确认需要更新哪些文件，而不是删除后盲目重装。

安装后需要重启Codex吗？ ​

不同版本处理方式可能不同。当前内置安装器说明新 Skill 会在下一轮任务中可用。若没有识别，可新建任务、刷新 Skills 列表，或按当前应用提示重新启动。

十、国内使用Codex Skills需要什么额度？ ​

安装 Skill 本身通常不是主要用量来源，真正消耗额度的是 Skill 触发后执行的任务。例如：

  • SEO Skill 抓取并分析多个页面；
  • 文档 Skill 渲染和反复修订文件；
  • Codex 读取大型仓库并运行测试；
  • 图片 Skill 生成多轮素材；
  • 自动化 Skill 执行网络请求和构建。
使用强度选择建议
偶尔运行单一Skill先用现有 Codex 额度测试
每周做几次内容或代码任务记录每次任务长度和限制
每天运行多步SEO、构建或开发流程关注 Pro 和持续 Codex 额度
大型项目与高频自动化控制任务边界，并评估更高额度方案

需要第三方 ChatGPT Pro 和 Codex 额度时，可以查看 zeogpt.com。选择前确认连接方法、额度计算、有效期、隐私规则和售后渠道。

十一、Codex Skill编写最佳实践 ​

1. SKILL.md保持精简 ​

只保留核心流程、判断标准和必要命令。详细资料放入 references/，避免每次触发都加载无关内容。

2. 脚本用于确定性操作 ​

文件转换、批量检查、固定报告生成等容易重复出错的工作，适合做成脚本；需要判断和创作的部分留给 Codex。

3. 描述触发条件，不写广告口号 ​

description 是路由条件，不是营销标题。使用“何时使用、能做什么、边界是什么”的写法。

4. 引用路径不要过深 ​

让 SKILL.md 直接链接必要参考文件。多层嵌套会让资料难以发现，也增加维护成本。

5. 用真实任务持续更新 ​

Skill 第一次写完很少完美。记录它在哪些任务中误触发、漏步骤或越界，再小范围修订。

6. 不把敏感信息写进Skill ​

API Key、密码、Cookie、服务器凭据和客户隐私不应进入 SKILL.md、脚本示例或 Git 仓库。

十二、常见问题 ​

Codex Skills的安装命令是什么？ ​

当前没有必要假定所有版本都支持同一条 codex skill install 命令。优先使用 Codex 内置 Skill Installer、Skills 界面或自然语言安装流程，也可以从 GitHub URL/仓库路径安装。

Codex Skill必须有SKILL.md吗？ ​

是。SKILL.md 是 Skill 的必需入口文件，至少包含 name、description 和工作流正文。

Skills默认安装在哪里？ ​

安装到 $CODEX_HOME/skills/<skill-name>；未单独设置时，通常是用户主目录下的 .codex/skills/。

可以一次安装多个Skills吗？ ​

安装器支持多个路径，但建议先安装少量真正需要的 Skills，逐个验证触发与脚本安全。

可以从私人GitHub仓库安装吗？ ​

可以，但需要当前环境已有相应 Git 凭据或 Token，并且不应在公开内容中泄露凭据。

Skill和MCP有什么区别？ ​

Skill 提供可复用的工作流程和知识；MCP 主要为 Codex 连接外部工具、服务或实时数据。一个 Skill 可以说明何时以及如何使用某个 MCP 服务。

Skill安装后为什么没有立刻出现？ ​

新 Skill 可能从下一轮任务开始可用。检查目录和 SKILL.md 后，新开任务或刷新当前 Codex 应用。

国内使用Skills必须购买Pro吗？ ​

安装和使用某个 Skill 不等于必须购买 Pro。是否需要更高额度取决于任务规模、模型、工具调用、文件数量和执行时间。

十三、总结 ​

Codex Skills 的正确使用顺序是：

  1. 先确认 Codex 已能正常运行和登录；
  2. 按工作场景选择少量 Skills；
  3. 使用内置安装器或可信 GitHub 路径安装；
  4. 核对目录中是否有完整 SKILL.md 和引用资源；
  5. 用真实小任务验证触发、脚本和边界；
  6. 把项目规则留给 AGENTS.md，把跨项目工作流做成 Skill；
  7. 高频开发或自动化任务再评估 Pro 与 Codex 额度。

Skills 真正的价值不是“装得多”，而是把一套已经验证过的做事方法稳定复用。对于 SEO 站长、内容团队和开发者，一个贴合自身项目的 Skill，通常比十个泛用提示词更有价值。

延伸阅读 ​

参考资料 ​

GPT Home 是独立的中文 AI 教程站，不代表 OpenAI。Codex 和 Skills 的具体界面、目录、安装器及可用能力以当前版本为准。