Skill 与插件

Codex 有三个经常被混淆的概念：插件、Skill 和 MCP。下面先把三者说清楚，再分别介绍 Skill 和插件的用法。

#三者关系

#Skill

#是什么

Skill 是给 Codex 预定义的一套工作流程。把常见任务（写 README、代码 Review、生成网页……）固化成 Skill，以后调用时直接按流程执行，不必每次重新解释规则。

什么时候做成 Skill？

• 同类任务经常重复，每次都要写一堆规则
• 想让输出更稳定，或团队多人共用同一套流程

不适合的情形： 一次性小任务、临时改文案、只是问个概念。

#和普通提示词的区别

#SKILL.md 最简结构

一个 Skill 至少需要一个 SKILL.md，frontmatter 写 name 和 description，正文描述工作流程：

---
name: readme-skill
description: 当用户需要生成 README、项目说明、安装教程、启动步骤时使用。
---

你是一个 README 文档生成助手。

任务：根据当前项目生成适合新手阅读的 README。

工作流程：
1. 阅读项目结构
2. 查看 package.json / 入口文件
3. 判断项目类型
4. 生成项目介绍、安装步骤、启动命令、文件结构说明、常见问题
5. 不确定的内容不要编造

输出格式：Markdown

完整目录结构（scripts/、references/、assets/ 均可选）：

.agents/skills/
└── readme-skill/
    ├── SKILL.md          ← 必须
    ├── scripts/          ← 可选，自动化脚本
    ├── references/       ← 可选，参考资料 / 模板
    └── assets/           ← 可选，示例文件

#创建与使用 Skill

桌面 AppCLI

使用已有 Skill： 打开插件页，已安装插件里的 Skill 会列出可用技能。

创建新 Skill：

1

新建 thread

在 App 里新建一个对话 thread。

2

调用 $skill-creator

输入 $skill-creator，这是内置的 Skill 创建助手。

3

描述需求

告诉它：用途是什么、何时触发、有哪些规则、期望的输出示例。

4

检查生成结果

确认生成的 SKILL.md 符合预期后保存即可使用。

#Skill 放在哪里

#插件

#是什么

插件是给 Codex 额外安装的「能力包」，可以让它连接更多外部工具、获得专项能力，或者把若干 Skill 和 MCP 打包成一个易于分发的单元。

#安装与管理

桌面 AppCLI

1

打开插件页

在 App 侧栏找到插件 / Plugins 入口，搜索或浏览可用插件。

2

安装

点击目标插件 → 查看详情 → Add to Codex。

3

使用

新开一个 thread，插件能力即在当前会话中生效。

#常见能力方向

#接着看