5分钟看懂 AI Skill 基本结构

小红书视频拆解评测与 Codex 最小实操

结论：视频对 Skill 基本结构的讲解是可复用的。一个 Skill 至少需要一个 SKILL.md；references、scripts、assets 按需要添加。对 Codex 来说，description 决定模型何时考虑调用这个 Skill，正文负责具体步骤、边界和输出要求。

图 1：视频用手绘方式区分必需文件和可选目录，画面已裁去字幕与页面推荐区

本文区分四类信息

来源边界：视频标题为《AI新手村：5分钟讲清skill的基本结构》，作者为谢慢慢。视频主要解释结构，没有完整演示从创建到运行的全过程；本文补充操作时会单独标注。

一 视频讲的基本结构

视频把 Skill 分成两部分：一个必须存在的说明文件，以及按任务复杂度添加的辅助目录。这个判断与当前 OpenAI 官方文档一致。

图 2：SKILL.md 中的名称 描述和正文	图 3：AI 根据 Skill 描述选择工作流

视频讲对了什么

• 可选目录不是每个 Skill 都必须创建。简单流程只用 SKILL.md 就能成立。

• 复杂资料应该拆到对应目录，正文只写什么时候读取或运行它们。

• AI 先通过名称和描述判断是否调用，再读取具体说明和支持文件。

Codex 中应统一写成 SKILL.md

视频手写为 skill.md，表达的结构概念没有问题。本文按当前官方示例统一使用大写文件名 SKILL.md，减少跨环境复制时的歧义。

二 SKILL.md 的三个组成部分

SKILL.md 由 YAML 头部和 Markdown 正文组成。视频把头部概括为 name 与 description，把正文称为 body。

图 4：视频把名称描述与正文分开	图 5：视频强调描述要说明用途和调用场景

本文补充的最小示例

---
name: video-tutorial-writer
description: Convert Douyin and Xiaohongshu posts into factual Chinese illustrated tutorials. Use when the user provides a social-media link and asks for a breakdown, evaluation, or reproduction guide.
---

1. Inspect the source and separate visible facts from inference.
2. Recommend one production route and wait for confirmation.
3. Write reproducible steps with inputs expected results and troubleshooting.
4. Deliver a checked Word document with centered images and captions.

Do not invent tools prompts parameters or creator workflow.

这段示例由本文编写，不是视频原文。它把触发条件放在 description，把具体执行步骤和禁止事项放在正文。

三 三个可选目录什么时候用

视频用手绘箭头说明 references、scripts 和 assets 会在 Skill 需要更多材料时参与执行。官方文档也建议把 SKILL.md 保持简洁，再从正文链接到支持文件。

图 6：视频解释三类支持目录的分工	图 7：视频回到名称描述正文的总结构

选择规则

• 能用清楚的文字步骤完成，就先不写脚本。

• 资料较长或经常更新，就放入 references，不要不断扩大正文。

• 只有真正需要复用的模板和静态素材才放入 assets。

• 正文必须写明何时读取哪个文件，不能只创建空目录。

四 在 Codex 中创建最小 Skill

以下为本文实操补充。当前官方文档推荐优先调用内置的 skill creator，也可以手动创建目录和 SKILL.md。

1 先把目标说清楚

写明 Skill 帮谁完成什么任务、何时触发、必须交付什么，以及哪些内容不能推断。目标越具体，description 越容易写准。

2 在 Codex 中调用创建器

在任务中输入 $skill-creator，再用一句完整需求说明名称、触发场景和输出。例如：创建一个 video-tutorial-writer Skill，在用户发送抖音或小红书链接并要求拆解教程时触发。

$skill-creator 创建一个名为 video-tutorial-writer 的 Skill
当用户提供抖音或小红书链接并要求拆解 评测或复刻教程时触发
先检查来源并提交推荐方案 用户确认后再制作 Word 图文教程
不得虚构工具 提示词 参数或创作者流程

3 先做只有一个文件的版本

建立 Skill 目录并写好 SKILL.md。先验证触发和输出是否正确，不要一开始就创建大量 references、scripts 和 assets。

4 用四类请求测试

分别测试直接请求、换一种说法的间接请求、缺少关键输入的请求，以及本来不应触发的请求。触发错误先改 description；触发正确但执行不稳再改正文。

最小测试表

关于 agents/openai.yaml

视频后段画到了 agents/openai.yaml。当前官方插件文档用它声明 MCP 工具依赖等扩展信息；它不是最小指令型 Skill 的必需文件，也不能替代 SKILL.md。小白先完成最小版本即可。

五 可复刻性与准确性评测

常见失败排查

发布或分享前检查

• SKILL.md 顶部有 name 和 description，正文写清步骤、边界与输出。

• description 同时回答做什么和什么时候调用。

• 可选目录有实际内容，正文明确写出读取或运行时机。

• 至少测试应该触发、不应触发、缺少输入和边界场景。

• 分享前检查脚本、模板和参考文件中是否含有隐私或密钥。

来源与版本说明

原视频 小红书 AI新手村 5分钟讲清skill的基本结构

官方资料 OpenAI Developers Build skills 核验日期 2026 年 9 月 23 日

本文区分来源画面事实、创作者讲解、官方资料与实操补充。实操步骤用于复刻同类工作流，不代表创作者在视频中的完整原始操作。

发布于 2026-08-03

原帖地址：https://www.xiaohongshu.com/explore/6a7062c60000000022017af2?xsec_token=ABR-6zsn2OipVUWwDEtYomFn2W020WwmQ4uBVk-ejK454%3D&xsec_source=pc_user

关于作者：谢慢慢

作者主页：https://www.xiaohongshu.com/user/profile/69e0670d00000000330275ab?xsec_token=ABazBIdq-pwMEhAPb7AXfXEmC-mmJ2mSLVh6fSZKeDbTU%3D&xsec_source=pc_user