简单说，Skill 就是给 AI Agent 准备的一份“能力说明书”。

它不只是提示词，而是一套可复用的工作方法：告诉 Agent 什么时候应该使用这个能 力、具体要遵循哪些步骤、需要读取哪些参考资料、是否可以调用脚本或素材。

这篇从最小的 Hello World Skill 开始，带你理解 Skill 的基本结构，再看 scripts、 references、assets 这些可选外挂资源，最后做一个真正能解决重复工作的实用 Skill。

第一步：认识skill，hello word skill

什么是skill ?

Skill 也可以理解成：给 claude/Codex/Agent （下文以codex 为例）用的“可触发小手册”。

Skill不是插件，也不是代码包本身。通常是一个文件夹，里面至少有一个 SKILL.md。当用户请求匹配到这个 skill 的 description 时，Codex 会读取 SKILL.md，然后按里面的流程做事。

最小结构是：

hello-world/
└── SKILL.md

最小 SKILL.md：

.md 是markdown 语法文件 如下所示说明： — 这个是分隔线 name skill 名字 description 描述会触发，更多可查询markdown 语法

# H1 标题

When this skill is used: 使用触发说明

name: hello-world

description: Say hello in a tiny deterministic way. Use when the user asks to run the hello-world skill, test a first skill, or says “hello world skill”.

Hello World

When this skill is used:

1. Reply exactly: Hello, world!
2. Add one short sentence saying the skill triggered successfully.

推荐放到：

~/.codex/skills/hello-world/SKILL.md

也就是：

mkdir -p ~/.codex/skills/hello-world
vim ~/.codex/skills/hello-world/SKILL.md

然后把上面的内容粘进去。之后开一个新 Codex 会话，试着说：

Use hello-world skill

或者：

run the hello world skill

一个 skill 最重要的是这三件事：

1. name

   ：小写、短横线命名，比如 hello-world

2. description

   ：触发条件，越清楚越好

3. 正文：被触发后 Codex 应该怎么做

这是第一个 hello world skill非常精简, 不需要 scripts/、references/、assets/。较复杂 skill 才需要的。

使用效果测试：

第二步 scripts/、references/、assets/ 都是 skill 的“可选外挂资源”。

scripts/：可执行工具

放脚本，用来做稳定、重复、容易写错的操作。

比如：

pdf-rotate/
├── SKILL.md
└── scripts/
└── rotate_pdf.py

适合放：

scripts/

• 转 PDF 的 Python 脚本
• 批量改文件名脚本
• 调 API 的固定脚本
• 生成报告的脚本
• 校验格式的脚本

作用是：让 Codex 不用每次重新现场写一遍脆弱代码，而是调用已经准备好的工具。

references/：给 Codex 读的知识库

放说明文档、规范、schema、流程、业务知识。它们不是直接输出给用户的，而是 Codex 在需要时读取。

比如：

company-report/
├── SKILL.md
└── references/
├── tone.md
├── metrics-schema.md
└── report-structure.md

适合放：

references/

• 公司品牌语气
• 数据库表结构
• API 文档摘录
• 内部流程规范
• 某类文章的写作规则

作用是：让 SKILL.md 保持简洁，把大块背景知识按需读取。

assets/：输出时会用到的素材

放模板、图片、字体、示例文件、项目骨架等“被拿来使用”的文件。

比如：

slide-maker/
├── SKILL.md
└── assets/
├── template.pptx
├── logo.png
└── brand-font.ttf

适合放：

assets/

• PPT 模板
• Word 模板
• Logo、图片、图标
• 前端项目模板
• CSS 样式模板
• 示例 Excel 文件

作用是：Codex 可以复制、修改、嵌入这些素材，生成最终产物。

一个简单区分：

SKILL.md = 告诉 Codex 怎么做
scripts/ = Codex 可以运行的工具
references/ = Codex 可以阅读的知识
assets/ = Codex 可以使用的素材

随手看三个真实可用的skill 目录

第三步：简单实践 做一个skill

skill 可以用来解决你的重复工作，比如我每次都要生成文章、标题、横幅、文章配图！ 直接和codex 说：根据目前的对话，生成一个skill，这个skill可以帮我生成横图和全文流程图就行,并教我一步一步添加到skill

1. 确认你的智能体 skill 目录,codex 默认如下

   ls ~/.codex/skills

2. 创建skill 文件夹并进入

mkdir ~/.codex/skills/ai-tech-content-creator && cd ~/.codex/skills/ai-tech-content-creator

1. 创建 SKILL.md 和 vscode 打开skill.md

   touch SKILL.md && code SKILL.md

2. 写入内容

name: ai-tech-content-creator

description: AI技术内容创作助手，根据技术文章、教程结构、AI工具介绍、开源项目说明或视频脚本，默认直接生成中文科技教程横幅封面和横版流程信息图图片；仅在用户明确要求时输出提示词或设计方案。

技术教程视觉生成器 Skill

角色定位

你是一名专业的 AI 技术内容创作者和视觉设计师。

你的任务：

根据用户提供的：

• 技术教程文章结构

• Twitter/X封面

• 长流程信息图

• AI工具介绍

• 开源项目说明

• 视频脚本

• 社交媒体内容

把复杂技术内容转换为适合传播的中文互联网内容。

默认输出：

1. 直接生成 Twitter / X 横幅封面图片

2. 直接生成横版教程流程信息图图片

只有当用户明确要求“给我提示词”“给我设计方案”“不要生成图片”时，才输出文字方案或图片生成 Prompt。

一、推特横幅生成规则

尺寸

固定：

1097 × 431 px

适用：

• Twitter/X文章封面

• 技术博客头图

• AI教程入口图

构图要求

采用：

左右分栏布局

左侧：

放置：

• 主标题

• 副标题

• 核心卖点

• 标签信息

标题要求：

主标题：

8-15个中文字符

突出：

项目名称 + 核心价值

例如：

Hermes安装入门

配置Telegram作为AI对话窗口

副标题：

一句话说明教程价值。

例如：

Ubuntu服务器17步手把手部署指南

右侧：

展示技术主体。

根据主题自动匹配：

AI工具：

• AI机器人

• 大模型

• 芯片

• 数据流

服务器：

• 云服务器

• Linux终端

• 网络线路

• SSH窗口

软件：

• 软件界面

• 工作流程

• UI窗口

二、视觉风格要求

统一采用：

中文互联网科技教程风格。

参考：

• B站科技UP主封面

• 小红书技术教程

• GitHub项目介绍页

• AI产品宣传海报

视觉关键词：

• 赛博朋克

• 科幻工业

• HUD界面

• 数据可视化

• 未来科技

颜色：

主色：

黑色背景

辅助：

青蓝霓虹

橙色强调

加入：

• 发光UI

• 代码窗口

• 数据流

• 服务器

• AI元素

三、教程流程信息图

根据文章步骤自动拆解。

输入：

1.

2.

3.

…

默认转换为：

横版教程流程图图片。

除非用户明确要求长图、竖图或小红书竖版，否则优先使用横图布局。

结构：

左上或顶部：

教程标题

中间：

横向步骤时间线

底部：

最终效果展示

每个步骤包含：

Step XX

标题：

一句话说明

内容：

最多2行文字

配图：

对应技术图标。

例如：

安装：

终端窗口

Telegram：

聊天机器人

服务器：

云计算图标

AI：

模型芯片

四、内容优化规则

如果文章文字过多：

自动压缩。

原则：

视觉效果 > 文字数量

不要生成：

• 大段文字

• PPT风格

• 密集说明

保持：简单、清晰易、传播

五、工作流程

收到教程后：

第一步：

分析：

• 教程主题

• 用户目标

• 核心卖点

• 步骤数量

第二步：

生成：

【Twitter / X 横幅封面图片】

包含：

标题

副标题

视觉元素

直接调用图片生成工具，不把 Prompt 作为默认输出展示给用户。

第三步：

生成：

【横版流程信息图图片】

包含：

步骤结构

模块布局

视觉元素

第四步：

如果支持图片生成：

直接生成图片。

如果图片生成工具不可用，再退回输出：

• 横幅设计方案

• 流程图设计方案

• 可复制的图片生成 Prompt

默认不要把 Prompt 展示给用户；Prompt 是内部生成图片用的工作材料。

六、适用场景

支持：

• AI工具教程

• Claude教程

• GPT教程

• Codex教程

• VPS教程

• Sing-box教程

• Linux部署教程

• 开源项目教程

• 软件安装教程

• 跨境工具教程

1. 试用技能，先退出再进入！

   codex

   use ai-tech-content-creator 标题: 什么是skill ? 从最小 hello word skill 到写一个实用
   skill ！ 流程:第一步，认识skill，hello word skilll 。第二步 ，scripts/、references/、
   assets/ 都是 skill 的“可选外挂资源”。第三步，简单实践 做一个skill。 根据标题和流程帮我生成图片

最后：

最后提醒一下，skill 是一个比较通用的工具 codex的skill, 放到claude 、 cursor 也许也能用，但是还是有相关细微差别的，就是不完全通用，但理念和主体内容高度可迁移！本文横幅和流程图就是 上文这个skill ai-tech-content-creator 生成的！这篇文章只是一个很简单的入门 ai skill ,要写好专业的skill, 还是要多研究优秀实用的skill 源码！

本文由我实操和codex辅助完成 ！如果遇到有什么问题可以找我，我会第一时间回复大家！如果文章对你有帮助，欢迎点赞、收藏、关注！我是想风一个关注出海与AI的创作者! 本文首发想风技术文档

本作品采用《CC 协议》，转载必须注明作者和本文链接