Codex Skill 安装基础以及常用 Skill 使用

前言

最近在使用 Codex 的过程中，发现它不只是一个“帮你写代码的 AI 工具”，更像是一个可以不断扩展能力的开发助手。

默认情况下，Codex 已经可以完成代码编写、问题排查、文档整理、项目分析等工作。但是如果我们经常让它处理某一类固定任务，比如前端页面设计、文章润色、查找工具、创建标准化工作流，每次都重新描述要求就会比较麻烦。

这时候就可以使用 Codex Skill。

Codex Skill 可以理解成 Codex 的“技能包”或者“工作流插件”。安装对应 Skill 后，Codex 在遇到特定任务时，会自动参考 Skill 中定义的规则、步骤和注意事项来处理问题。这样不仅能减少重复提示词，也能让输出结果更加稳定。

本文主要记录一下 Codex Skill 的基础安装方法，并以几个常用 Skill 为例进行说明，包括：

• find-skills：用于查找和推荐合适的 Skill
• skill-creator：用于创建和优化自己的 Skill
• frontend-design：用于生成更高质量的前端页面和 UI
• humanizer：用于润色文字，减少明显的 AI 写作痕迹

下面就从 Codex 和 Skill 的基本概念开始，一步一步演示安装和使用过程。

Codex 简介

Codex 是 OpenAI 面向开发场景推出的 AI 编程助手，可以帮助开发者完成代码编写、项目理解、Bug 修复、命令执行、文件修改、文档生成等任务。

和普通聊天式 AI 不同，Codex 更偏向真实开发环境中的协作。它可以读取项目文件、理解代码结构、根据需求修改代码，并在需要时运行终端命令进行验证。

简单理解，Codex 可以做这些事情：

1. 阅读和分析项目代码
2. 根据需求新增或修改功能
3. 修复报错和 Bug
4. 编写 README、教程、接口文档
5. 生成前端页面和组件
6. 执行测试、检查运行结果
7. 根据固定流程完成重复性任务

Codex Skill 是什么

Codex Skill 可以理解成 Codex 的“技能包”。

平时我们让 Codex 做事情，经常需要说很多背景，比如：

帮我写一个前端页面，注意设计感，别太模板化，要有完整交互。

如果安装了 frontend-design 这种 Skill，以后 Codex 遇到前端页面、组件、UI 美化相关任务时，就会按照这个 Skill 里面的工作方式来处理。

简单说：

普通 Codex = 默认能力
Codex + Skill = 默认能力 + 专项工作流

Skill 一般由一个 SKILL.md 文件组成，里面会写清楚：

什么时候使用这个 Skill
使用时应该按什么步骤做
输出格式是什么
有哪些注意事项

环境准备

1. 安装 Node.js

因为 Skills CLI 通常通过 npx 使用，所以电脑上需要先有 Node.js。

打开终端，输入：

node -v
npx -v

如果能看到版本号，说明环境正常。

如果提示找不到命令，先去安装 Node.js LTS 版本，安装完成后重新打开终端。

2. 检查 Skills CLI

继续执行：

npx skills --help

能看到帮助信息就可以继续。

常用命令如下：

命令	作用
npx skills find 关键词	搜索 Skill
npx skills add 包名 -g -y	安装 Skill
npx skills check	检查 Skill 更新
npx skills update	更新已安装 Skill

查找 Skill

先搜索再安装，不要看到名字差不多就直接装。

比如想找前端设计相关 Skill：

npx skills find frontend

想找写作润色相关 Skill：

npx skills find writing

想找创建 Skill 相关工具：

npx skills find skill creator

这里重点看几个信息：

1. Skill 名称
2. Skill 描述
3. 来源是否可信
4. 是否适合自己的任务

如果已经安装了 find-skills，也可以直接在 Codex 里面问：

帮我找一个适合做前端界面设计的 Skill，并告诉我安装命令。

find-skills 的作用就是帮我们发现合适的 Skill，并且提醒我们检查来源、安装量和适用场景。

安装 Skill

安装命令格式一般是：

npx skills add <owner/repo@skill-name> -g -y

注意：这里的 <owner/repo@skill-name> 是占位符，需要替换成你搜索到的真实 Skill 包名。

例如搜索结果里面给出的安装命令可能类似：

npx skills add xxx/xxx@frontend-design -g -y

不要直接复制我这里的 xxx/xxx，以你自己终端搜索结果为准。
当然如果是比较出名的也直接对话让 Codex 直接帮你安装。

参数说明

参数	说明
add	添加并安装 Skill
-g	全局安装，所有 Codex 会话都可以用
-y	自动确认安装

安装完成后，可以检查一下：

npx skills check

如果本地 Skill 目录中出现了对应文件夹，基本就说明安装成功了。

常见目录类似：

C:\Users\你的用户名\.agents\skills

或者：

C:\Users\你的用户名\.codex\skills

具体位置和你使用的 Codex 环境有关。

检查是否安装成功

最简单的方法就是直接让 Codex 使用它。

例如测试 frontend-design：

使用 frontend-design 帮我做一个 SaaS 数据看板首页，要求信息密度高一些，不要做成宣传页。

测试 humanizer：

使用 humanizer，把下面这段文章改得更自然一些，不要改变原意。

如果 Codex 回复时开始按照这个 Skill 的规则工作，就说明可以正常使用。

常用 Skill 说明

下面是这次推荐的 4 个 Skill。

1. find-skills

作用：

发现、搜索、筛选和安装 Skill。

适合场景：

不知道有没有现成 Skill
想让 Codex 增加某个领域能力
想找设计、测试、部署、写作等专项技能

使用示例：

帮我找一个适合做 SEO 文章优化的 Skill。

它会帮你找候选 Skill，并说明适合什么场景、怎么安装。

2. skill-creator

作用：

创建新的 Skill，修改已有 Skill，优化 Skill 触发效果。

适合场景：

你有一套固定工作流
经常重复让 Codex 做同一件事
想把经验沉淀成一个可复用 Skill

使用示例：

我想创建一个 Skill，用来把会议记录整理成行动项、负责人和截止时间。

Codex 会帮你梳理触发条件、输出格式、处理步骤，然后生成 SKILL.md。

3. frontend-design

作用：

让 Codex 更擅长做前端界面、网页、组件和 UI 美化。

适合场景：

写 HTML/CSS 页面
做 React 组件
做后台管理系统
做数据看板
做落地页
优化页面视觉效果

使用示例：

使用 frontend-design 做一个后台管理系统首页，包含数据卡片、趋势图和任务列表。

这个 Skill 的重点不是只生成页面结构，而是会考虑设计感、布局、交互、响应式和视觉层次。

4. humanizer

作用：

把 AI 味比较重的文字改得更自然。

适合场景：

博客文章润色
说明文档优化
邮件改写
产品介绍优化
减少明显的 AI 套话

使用示例：

使用 humanizer 润色这段话，让它更像真人写的，但是不要改变意思。

它会重点处理这些问题：

句子太工整
套话太多
表达太空
过度总结
明显 AI 语气

创建自己的 Skill

如果你经常让 Codex 做同一类事情，就可以考虑自己写一个 Skill。

最小目录结构如下：

my-skill/
    SKILL.md

如果复杂一点，可以这样：

my-skill/
    SKILL.md
    references/
    scripts/
    assets/

其中 SKILL.md 是必须的。

一个简单示例：

---
名称：会议事项清单
描述：当用户希望将会议记录转化为行动事项、负责人、截止日期和后续问题时，请使用此功能。
---
# 会议事项清单
当收到会议纪要时：
1. 提取具体的行动事项。
2. 如果有相关信息，需明确列出所有者、截止日期以及依赖关系。
3. 将未找到的业主或逾期未完成的任务标记为“待确认”。
4. 生成一个 Markdown 表格。
5. 如果存在重要信息缺失的情况，以 3 个后续问题作为结尾。

这个文件写好后，Codex 就知道遇到会议纪要整理任务时应该怎么处理。

如果不会写，可以直接让 skill-creator 帮你生成：

使用 skill-creator 帮我创建一个会议纪要整理 Skill。

常见问题

1. 提示找不到 npx

一般是 Node.js 没安装，或者安装后终端没有重启。

解决办法：

安装 Node.js LTS
关闭终端
重新打开终端
再次执行 node -v 和 npx -v

2. 安装后 Codex 没有自动触发 Skill

可以在提示词里面明确写出来：

使用 humanizer ...
使用 frontend-design ...
使用 skill-creator ...

如果还是不触发，检查 Skill 的 description 是否写得太弱。Skill 的触发主要依赖描述。

3. 能不能一次安装很多 Skill

可以，但是不建议一上来装太多。

建议先安装自己高频用到的 3 到 5 个。比如：

find-skills
skill-creator
frontend-design
humanizer

后面需要什么再补。

4. Skill 有没有安全风险

有可能。

安装前建议看一下来源和内容，尤其是带 scripts、联网、读写文件、执行命令的 Skill。

不熟悉来源的 Skill，不建议直接全局安装。

总结

整体流程其实就这几步：

1. 准备 Node.js 和 npx
2. 用 npx skills find 搜索 Skill
3. 检查 Skill 来源和描述
4. 用 npx skills add 安装
5. 用真实任务测试是否生效
6. 常用流程可以用 skill-creator 做成自己的 Skill

这几个 Skill 里面，我个人建议先从 find-skills 和 frontend-design 开始用。
如果你经常写文章，再加一个 humanizer。
如果你已经有自己的固定工作流，就可以继续用 skill-creator 做自己的 Skill。

---

暂时先这样吧，如果实在看不明白就留言，看到我会回复的。希望这个教程对您有帮助！
路漫漫其修远，与君共勉。