官方 Skill 结构拆解：先读懂 SKILL.md，再看脚本

这页只做“读懂结构”，不教你直接安装。一个 Skill 通常不是一句提示词，而是一组可复用的说明、资源和可选脚本。新手先学会看结构，才知道它会在什么场景触发、会读什么、可能执行什么。

先看四层结构

1. SKILL.md

这是入口文件。重点看两块：

• frontmatter：通常包含 name 和 description。
• 正文：说明 Skill 被调用后应该怎么做、输出什么、注意什么。

description 很关键。它不只是介绍，而是模型判断“什么时候该用这个 Skill”的线索。描述太泛，容易乱触发；描述太窄，可能该用时不用。

2. references/

这类目录通常放长文档、规则、模板、背景资料。它适合放不想每次都塞进上下文的内容。

新手要看：这些资料是事实来源、流程说明，还是组织内部规则。不要把社区仓库里的 references 当官方事实。

3. assets/

这类目录可能放模板、图片、示例文件、设计资源。它通常不是危险点，但可能涉及版权、品牌和可复用范围。

新手要看：这些资源能不能公开复用，有没有 License。

4. scripts/

这是最需要小心的部分。脚本可能读写文件、联网、安装依赖、调用外部工具。

新手默认动作：只读脚本，不运行。先让 AI 解释脚本做什么、会改哪里、是否需要凭证。

可复制拆解提示词

请帮我只读拆解这个 Skill。不要安装，不要执行脚本，不要运行命令。

Skill 链接或本地路径：{URL 或路径}
访问日期：2026-06-16
我的目标：学习它的结构，不直接使用

请输出：
1. 入口文件是不是 SKILL.md
2. frontmatter 里的 name 和 description 分别是什么
3. description 适合什么触发场景，不适合什么场景
4. 正文把任务拆成了哪些步骤
5. 是否有 references、assets、scripts 或其他目录
6. references 里是否包含需要复核的外部事实
7. assets 是否涉及版权、品牌或模板复用
8. scripts 是否会读文件、写文件、联网、删除、上传或执行命令
9. 这个 Skill 适合只读学习、空仓库测试，还是暂不安装
10. 如果我要改写成自己的 Skill，应该保留什么、删掉什么

拆解时不要混淆三件事

• Skill：描述一个可复用工作流。
• Plugin / Extension：更像分发和安装单元，可能打包多个 Skill、命令、MCP、主题或配置。
• MCP：让工具连接外部数据和动作，风险重点是权限、Token、作用域和工具调用。

看到一个仓库时，先判断它到底是哪一类，再决定怎么审查。

成功标志

• 你能说出 Skill 什么时候会触发。
• 你知道它有没有脚本。
• 你知道它会不会要求外部服务、账号或 Token。
• 你能把它拆成“可学习的结构”和“不能直接照搬的部分”。
• 你没有因为它来自官方示例仓库，就默认适合生产使用。

常见错误

• 只看 name，不看 description。
• 看到官方示例就直接安装。
• 不读 scripts，直接运行。
• 把 Plugin、Extension、Skill、MCP 混成一个概念。
• 把示例里的组织流程照搬到自己的项目。

下一步

如果你只是评估安装风险，先用 Skill 静态审查提示词。如果需要更完整的安装前检查，再看 Skill 安装风险检查。

来源与日期

• 来源：Codex Agent Skills、Claude Code Skills、anthropics/skills。
• 分享日期：2026-06-16。
• 复测日期：2026-06-16。