必须配置skill才能让codex按团队规范自动工作，它是可复用、可共享、可版本管理的工作流封装体；skill按项目级＞用户级＞系统级优先级加载，需手动创建目录并确保skill.md存在且为utf-8无bom编码。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在 Codex 里让 AI 按照你团队的代码规范、部署流程或测试模板自动干活，必须配置 Skill——它不是临时提示词，而是可复用、可共享、可版本管理的工作流封装体。
确认 Skill 存放目录位置
Codex 按优先级加载 Skill：项目级（./.codex/skills/）＞用户级（~/.codex/skills/）＞系统级（/opt/codex/system/skills/）。日常开发推荐用用户级目录，一配即全局生效。
Windows 用户路径为：C:\Users\你的用户名\.codex\skills\；macOS 用户路径为：~/.codex/skills/。
【必须提前创建该文件夹】如果目录不存在，Codex 不会自动创建，后续放入技能也不会被识别。
导入本地 Skill 包（解压即用）
方法一：手动解压放置
拿到 Skill 压缩包（如 api-generator.zip）后，先完整解压，确保解压后根目录下直接包含 SKILL.md 文件——这是 Codex 识别 Skill 的唯一硬性条件，缺了就当普通文件夹忽略。
把整个解压后的文件夹（例如名为 api-generator），直接复制粘贴进上一步确认好的 .codex/skills/ 目录中。
方法二：命令行一键解压（适合批量操作）
打开终端，cd 进入 .codex/skills/ 目录，执行：unzip ~/Downloads/api-generator.zip -d ./。注意末尾的 -d ./ 表示解压到当前目录，否则可能嵌套一层。
安装 GitHub 上的 Skill（在线拉取）
第一步：在 Codex 对话框中输入指令
直接键入：$skill installer https://github.com/ComposioHQ/awesome-codex-skills，回车执行。
第二步：选择安装目标
终端会弹出交互菜单，提示「Install to user directory?」，按 y 确认装到用户级目录（默认路径 ~/.codex/skills/）；若想只在当前项目生效，需额外加 --local 参数，即：$skill installer --local https://github.com/xxx/skill-repo。
第三步：等待拉取完成并校验
成功后终端显示 ✅ Installed skill: xxx；此时进入 .codex/skills/ 目录，运行 ls -l xxx/SKILL.md，能正常输出文件信息才算真正就位。
创建并启用自定义 Skill
新建一个文件夹，命名为你想要的 Skill 名（如 vue-linter），在其内部新建 SKILL.md 文件，内容至少包含以下 YAML 头部：
```yaml
---
name: vue-linter
description: 检查 Vue 单文件组件是否符合团队 ESLint + Prettier 规范
---
## 触发规则
当用户提到“检查 Vue 组件”或“lint this .vue file”时启用
## 执行步骤
1. 提取当前对话中附带的 .vue 文件内容
2. 调用本地 eslint --fix --ext .vue 命令
3. 返回修复后代码及警告摘要
```
保存后，把整个 vue-linter 文件夹放入 .codex/skills/ 目录。重启 Codex 客户端或点击右上角 Skills 插件里的刷新按钮，新 Skill 就会出现在列表中。
【SKILL.md 必须是 UTF-8 编码且无 BOM】Windows 记事本另存为时默认带 BOM，会导致 Codex 解析失败，建议用 VS Code 或 Notepad++ 保存。
验证 Skill 是否生效
在任意对话中输入触发语句，例如：$vue-linter 检查这个 Vue 组件，注意开头是 $ 符号而非 @ 或 /。
如果返回结果为空或提示「Skill not found」，先检查 Skills 插件面板里是否有该 Skill 名；没有则说明路径或 SKILL.md 格式有误；有但不响应，可能是触发规则未匹配，需回头修改 SKILL.md 中的「触发规则」段落。
