夜雨聆风如果你还在用 Codex 做基本的代码补全，那只能说你还只发挥了它不到十分之一的能力。今天这篇文章，我要带你深入了解 Codex 最强大的功能之一 —— Skill（技能）系统。
简单来说，Skill 就像是给 Codex 装上的"外挂插件"。一个 Skill 就是一组精心编写的指令文件（SKILL.md），告诉 Codex 在特定场景下该如何行事。无论是生成公众号文章、创建视频、管理浏览器，还是搭建复杂的开发工作流，都有对应的 Skill 在背后默默工作。
据不完全统计，目前 Codex 社区已经积累了超过 80 个高质量 Skill，涵盖内容创作、视频制作、开发者工具等多个领域。接下来，我就手把手教你从零开始安装、使用甚至创建自己的 Skill。
一、什么是 Skill？它为什么这么重要？
Skill 的本质，是一套模块化、自包含的知识包。你可以把它理解为 Codex 的"专业认证"——通过加载不同的 Skill，Codex 就能从通用编程助手，瞬间变身成为公众号写手、视频创作者、甚至是浏览器自动化专家。
每个 Skill 都遵循统一的结构规范。最核心的文件是 SKILL.md，它包含两部分：
- Frontmatter（元数据）
：用 YAML 格式定义 name（技能名称）和description（触发描述）。Codex 正是通过读取 description 来判断何时应该激活这个 Skill。 - Body（正文指令）
：详细的 Markdown 格式操作指南，告诉 Codex 在具体场景下该执行哪些步骤、调用什么脚本、遵循什么规范。
除了 SKILL.md，一个完整的 Skill 还可能包含 scripts/（可执行脚本）、references/（参考资料）、assets/
💡 核心理念：Skill 的设计哲学是"默认假设 Codex 已经很聪明"。因此好的 Skill 不会啰嗦解释基础概念，而是聚焦于 Codex 本身不具备的领域知识和操作流程。
二、Skill 的安装位置与目录结构
在 Windows 系统上，Skill 的默认安装路径是：C:\Users\你的用户名\.codex\skills\
.codex/skills/├── .system/ ← 系统预装 Skill（无需手动安装）│ ├── imagegen/│ ├── skill-creator/│ ├── skill-installer/│ ├── plugin-creator/│ └── openai-docs/├── ai-news-digest/ ← 用户安装的 Skill├── aws-wechat-article-*/ ← 公众号写作相关 Skill 套件├── hyperframes/ ← 视频制作相关├── browser/ ← 浏览器控制└── ... ← 更多用户自定义 Skill注意带有 .system 前缀的目录——这些是 Codex 自带的系统级 Skill，包括 Skill 安装器、Skill 创建器、图片生成器等核心功能。你不需要也不应该手动安装它们。
另外，还有一个容易被忽略的位置：C:\Users\你的用户名\.codex\plugins\cache\。这里存放的是通过插件机制安装的 Skill，比如从 openai-curated 仓库拉取的 Cloudflare、GitHub、Gmail 等专业 Skill。这些 Skill 由 Codex 自动缓存和管理，通常不需要手动干预。
三、如何安装 Skill？三种方法任你选
方法一：使用 Skill Installer（推荐）
Codex 内置了一个专门的 Skill 安装工具，位于 .system/skill-installer 目录下。这是最官方、最便捷的安装方式。
具体操作步骤如下：
# 1. 列出所有可用的精选 Skillpython scripts/list-skills.py# 2. 列出实验性 Skillpython scripts/list-skills.py --path skills/.experimental# 3. 以 JSON 格式查看详细信息python scripts/list-skills.py --format json# 4. 从 GitHub 仓库安装指定 Skillpython scripts/install-skill-from-github.py \ --repo openai/skills \ --path skills/.curated/your-skill-name# 5. 通过 URL 直接安装python scripts/install-skill-from-github.py \ --url https://github.com/openai/skills/tree/main/skills/.curated/your-skill-name安装完成后，记得重启 Codex，新安装的 Skill 才会生效。这一点非常重要，很多新手朋友就是忘了这一步，导致安装了 Skill 却找不到。
📌 小贴士：Skill Installer 支持从任何 GitHub 仓库安装 Skill，不仅限于 openai 官方仓库。这意味着只要你找到了别人分享的 Skill 仓库地址，都可以直接安装使用。对于私有仓库，需要使用已有的 git 凭据或设置 GITHUB_TOKEN/GH_TOKEN 环境变量。
方法二：手动下载安装
如果你更习惯手动操作，或者 Skill 不在 GitHub 上，也可以直接下载 SKILL.md 文件到指定目录：
# 在你的 skills 目录下创建新的 Skill 文件夹mkdir C:\Users\你的用户名\.codex\skills\my-custom-skill# 将 SKILL.md 文件放入该目录# 如果有 scripts/、references/、assets/ 等子目录也一并放入这种方法虽然简单直接，但需要注意命名规范：Skill 文件夹名称应与 SKILL.md 中定义的 name 字段保持一致，否则 Codex 可能无法正确识别。
方法三：通过插件系统安装
Codex 还支持更高级的插件机制。一个 Plugin 可以捆绑多个 Skill、MCP 工具和自定义应用。使用 plugin-creator Skill 可以快速创建和安装插件：
# 创建一个基础插件python3 scripts/create_basic_plugin.py my-plugin --with-marketplace# 创建包含多种组件的完整插件python3 scripts/create_basic_plugin.py my-plugin \ --with-skills --with-hooks --with-scripts \ --with-assets --with-mcp --with-apps --with-marketplace# 验证插件结构是否正确python3 scripts/validate_plugin.py my-plugin插件安装后会出现在 .codex/plugins/cache/ 目录下，由 Codex 自动管理缓存和更新。
四、如何使用已安装的 Skill？
安装好 Skill 之后，使用它们其实非常简单——在对话中提及 Skill 名称即可触发。Codex 会自动读取 Skill 的 description 字段，判断是否匹配你的需求。
举个例子，如果你想让 Codex 帮你生成一篇公众号文章，只需要说：
使用 $wechat-article-writer 写一篇关于 AI 编程的文章这里的 $wechat-article-writer 就是 Skill 名称，前面加个美元符号是触发语法。Codex 收到这个指令后，会加载对应的 SKILL.md 文件，按照里面定义的工作流程自动完成搜索资讯、采集图片、撰写文章、生成 HTML 等全部步骤。
如果不显式提及 Skill 名称，Codex 也会根据你的描述智能判断是否应该使用某个 Skill。比如你说"帮我生成一张图片"，即使没提到 $imagegen，Codex 依然会识别并调用图片生成 Skill。
实际使用中，你可能会遇到多种 Skill 组合的情况。比如先用 $aws-wechat-article-topics 生成选题和标题，再用 $aws-wechat-article-writing 撰写正文，最后用 $aws-wechat-article-formatting 进行排版。这种组合使用的方式，能让整个创作流程更加高效流畅。
⚡ 使用技巧：Skill 的 description 字段写得越全面，Codex 就越容易在合适的时机自动触发。这也是为什么好的 Skill 会在 description 中列出各种触发场景和关键词。
五、如何创建自己的 Skill？
如果你觉得现有的 Skill 不够用，完全可以自己动手创建一个。Codex 提供了专门的 skill-creator 工具来帮助你快速上手。
创建 Skill 的基本流程如下：
# 1. 初始化 Skill 骨架（自动生成 SKILL.md 和必要目录）python3 scripts/init_skill.py my-awesome-skill# 2. 编写 SKILL.md 文件# - 填写 YAML frontmatter（name + description）# - 编写 Body 部分的详细操作指令# 3. 添加可选资源mkdir scripts/ # 可执行脚本mkdir references/ # 参考资料mkdir assets/ # 模板和图片等资源# 4. 运行验证python3 scripts/quick_validate.py ./my-awesome-skill编写 SKILL.md 时，有几个关键原则需要牢记：
- 简洁为王
：Context Window 是公共资源，不要浪费tokens解释 Codex 已经知道的东西。能用一句话说明白的，绝不写两段。 - 描述要全面
：description 字段是 Skill 的"触发器"，必须涵盖所有可能的使用场景和触发条件。这部分写得好，Codex 才能精准识别你的需求。 - 设定合适的自由度
：简单任务给宽泛指导（高自由度），复杂易错的操作给精确步骤（低自由度）。就像开车过窄桥需要护栏，而在开阔田野上可以随便走。
一个典型的 SKILL.md 文件结构如下：
---name: my-skill-namedescription: 当用户需要做 X、Y、Z 时使用此技能。触发条件包括...---# 我的 Skill 名称## 工作流程第一步做什么...第二步做什么...## 注意事项一些重要的提醒...创建完成后，建议用子代理进行正向测试——让另一个 Codex 实例在不告知测试目的的情况下使用你的 Skill 完成实际任务，看看效果是否符合预期。这是检验 Skill 质量的最佳方法。
六、常见问题与故障排查
在实际使用过程中，你可能会遇到一些问题。下面整理了最常见的几个场景及解决方案：
Q1：安装了 Skill 但 Codex 不识别怎么办？
A：最常见的原因是忘记重启 Codex。Skill 列表在 Codex 启动时加载，安装新 Skill 后必须重启才能生效。另外检查 SKILL.md 文件的 YAML frontmatter 格式是否正确，特别是 name 和 description 字段是否存在。
Q2：GitHub 安装失败，提示权限错误？
A：如果是私有仓库，需要配置 Git 凭据或在环境变量中设置 GITHUB_TOKEN / GH_TOKEN。Skill Installer 会自动尝试 HTTPS 和 SSH 两种方式，如果都不行，可以尝试手动下载安装。
Q3：Skill 的脚本运行报错，说缺少依赖？
A：部分 Skill 需要额外的 Python 包或其他依赖。仔细阅读 SKILL.md 中的说明，通常会列出需要的依赖项。比如在 imagegen Skill 中就需要安装 openai 和 pillow 包。
Q4：如何查看当前已安装的所有 Skill？
A：可以直接浏览 ~/.codex/skills/ 目录下的所有文件夹，每个文件夹代表一个已安装的 Skill。也可以使用 list-skills.py 脚本列出官方精选 Skill 及其安装状态。
Q5：Skill 之间会不会冲突？
A：正常情况下不会。每个 Skill 的触发由 description 字段控制，Codex 会根据你的具体需求智能选择最匹配的 Skill。但如果多个 Skill 的 description 高度相似，可能会出现误触发。这时可以通过调整 description 的关键词来区分。
"Skill 系统的真正威力在于它的可扩展性。每一个用户都可以为自己的 Codex 打造专属技能，让它越来越懂你的工作方式。"
— END —
如果觉得这篇文章有帮助，欢迎分享给同样在用 Codex 的朋友 👆
