最近，一条关于 ELI5 Skill 的分享在开发者社区流传开来。
它的用途很直接：把一个复杂主题交给 Claude，最后得到的不是几千字解释，而是一个大图、少字、可以交互的 HTML 页面。
例如，你可以让它解释 Agent、DNS、RAG、模型后训练，也可以把一个陌生代码库交给它，让它画出项目结构和模块关系。
最让人意外的不是生成效果，而是它的核心提示词短得近乎离谱。
整个 SKILL.md 只有 10 行。去掉元数据后，真正负责工作的主要指令只有一句：
Explain like I'm someone who knows nothing about this topic,
using a HTML artifact with big pictures and few words.
Topic: $ARGUMENTS
Explain like I'm someone who knows nothing about this topic,
using a HTML artifact with big pictures and few words.
Topic: $ARGUMENTS
翻译过来就是：把我当成一个对这个主题一无所知的人，用大图和少量文字制作一个 HTML 页面进行解释。
没有规定页面必须分几栏，没有指定配色，也没有列出几十条前端规范。它只明确目标、受众和输出形式，剩余判断交给模型。
这恰好揭示了当前 Agent Skill 的一个重要变化：当模型能力足够强时，好 Skill 不一定更长，而是更清楚。
先说清楚：这是社区插件，不是官方产品功能
ELI5 目前位于 anthropics/claude-plugins-community 仓库中。该仓库是 Anthropic 社区插件市场的只读镜像，目录里的插件经过相应的提交、扫描和分发流程。
但它与 anthropics/claude-plugins-official 仍然是两回事。
- 仓库由 Anthropic 组织托管；
- ELI5 的作者字段是 Thariq Shihipar；
- 插件版本为 1.0.0，采用 MIT License；
- 它属于社区插件，不应描述为 Anthropic 官方维护的产品功能；
- “Anthropic 内部爆火”来自社区分享，不是官方公布的使用数据。
这个区分不影响使用，却能避免把社区项目写成官方背书。
一句话提示词，为什么能产生这么明显的变化？
ELI5 看起来只写了一句话，实际上它同时做了三项重要决策。
1. 先改变读者假设
“someone who knows nothing about this topic”要求模型从零开始解释。
这会迫使模型减少未经说明的缩写、术语和前置知识。例如，普通回答可能直接讨论向量数据库、Embedding 和召回率；ELI5 则需要先解释“为什么要从很多资料里找到最相关的几段”。
2. 再改变内容载体
它没有要求“写一篇文章”，而是要求生成 HTML artifact。
一旦输出载体变成网页，模型会自然考虑：
- 哪些关系适合画成流程；
- 哪些概念可以并排对比；
- 哪里需要颜色和图标建立层级；
- 哪些步骤适合做成点击或逐步演示；
- 页面如何在有限空间里讲完一个故事。
3. 最后限制信息密度
“big pictures and few words”不是装饰要求，而是内容编辑规则。
大图意味着要优先呈现关系，少字意味着必须舍弃枝节。模型不能把原来的长回答简单塞进网页，而要先判断：如果读者只能记住三件事，应该是哪三件？
如何在 Claude Code 中安装 ELI5？
方法一：通过社区插件市场安装
先在终端添加社区插件市场：
claude plugin marketplace add anthropics/claude-plugins-community
claude plugin marketplace add anthropics/claude-plugins-community
再安装 ELI5：
claude plugin install eli5@claude-community
claude plugin install eli5@claude-community
安装完成后，在 Claude Code 中输入：
/eli5 DNS 是怎么工作的？
/eli5 DNS 是怎么工作的？
如果 Skill 被正确发现，Claude 会根据主题生成图解型 HTML 页面。
方法二：把 Skill 文件交给 Agent 安装
ELI5 本质上是一份 SKILL.md。你也可以把仓库地址交给具备文件操作能力的 Agent：
请读取并安装这个 Skill：
https://github.com/anthropics/claude-plugins-community/blob/main/eli5/skills/eli5/SKILL.md
安装前先告诉我将写入哪个目录，不要覆盖同名文件。
请读取并安装这个 Skill：
https://github.com/anthropics/claude-plugins-community/blob/main/eli5/skills/eli5/SKILL.md
安装前先告诉我将写入哪个目录，不要覆盖同名文件。
在 Codex 或其他 Agent 环境中，Skill 目录和触发方式可能不同。不要默认所有产品都支持 /eli5 斜杠命令。更通用的调用方式是直接说明：
使用 ELI5 Skill，把“DNS 是怎么工作的”制作成大图少字的 HTML 图解。
使用 ELI5 Skill，把“DNS 是怎么工作的”制作成大图少字的 HTML 图解。
ELI5 最适合解决哪几类问题？
场景一：第一次接触陌生概念
/eli5 什么是模型后训练？它为什么能提升模型能力？
/eli5 什么是模型后训练？它为什么能提升模型能力？
普通回答容易列出监督微调、偏好优化和强化学习等术语。ELI5 更适合先讲清“预训练让模型知道很多，后训练教模型在具体任务中把知识用对”。
场景二：刚接手一个陌生代码库
使用 ELI5 Skill 阅读当前项目，然后用 HTML 图解说明：
1. 用户请求从哪里进入；
2. 核心模块如何传递数据；
3. 哪些外部服务和数据库会被调用；
4. 新人应该先读哪 5 个文件。
使用 ELI5 Skill 阅读当前项目，然后用 HTML 图解说明：
1. 用户请求从哪里进入；
2. 核心模块如何传递数据；
3. 哪些外部服务和数据库会被调用；
4. 新人应该先读哪 5 个文件。
这比一句“解释这个项目”更有效，因为它给出了新人真正关心的阅读顺序。
场景三：看懂一项技术取舍
/eli5 为什么这个项目使用消息队列，而不是让服务直接互相调用？
/eli5 为什么这个项目使用消息队列，而不是让服务直接互相调用？
页面可以把两种架构并排展示，让读者看到吞吐、耦合、重试和复杂度的差别。
场景四：复盘事故原因
使用 ELI5 Skill 根据当前事故报告制作一页可视化复盘：
展示正常链路、故障链路、首次异常、放大因素和最终影响。
不要补充报告中没有出现的原因。
使用 ELI5 Skill 根据当前事故报告制作一页可视化复盘：
展示正常链路、故障链路、首次异常、放大因素和最终影响。
不要补充报告中没有出现的原因。
最后一句非常关键。ELI5 擅长表达，不代表它应该自行补齐事故事实。
场景五：准备面试与复习
/eli5 RAG 是怎么工作的？如何提高召回率？
/eli5 RAG 是怎么工作的？如何提高召回率？
可以先让它画出查询、检索、重排和生成的主流程，再要求第二页比较分块策略、混合检索和重排模型。
场景六：制作内部培训材料
使用 ELI5 Skill 向非技术同事解释我们的客服 Agent：
只讲用户提问、知识库检索、模型回答、人工接管四个环节。
每屏只表达一个结论，最后增加 3 道理解检查题。
使用 ELI5 Skill 向非技术同事解释我们的客服 Agent：
只讲用户提问、知识库检索、模型回答、人工接管四个环节。
每屏只表达一个结论，最后增加 3 道理解检查题。
这类页面可以作为培训开场，但正式制度、操作规范和风险说明仍应链接到原始文档。
原版太短？可以这样升级
原始 ELI5 适合快速探索。如果要稳定用于团队内容，可以增加几条必要约束，但不要把它扩写成几千字的网页规范。
下面是一份更适合实际项目的版本：
---
name: eli5-project
description: Explain an unfamiliar technical topic or project with a visual HTML artifact.
---
Explain the topic to a reader who has no prior knowledge.
Create a self-contained HTML artifact with large visuals and few words.
Requirements:
1. Start with a one-sentence explanation of what it is and why it matters.
2. Show the main flow before introducing details.
3. Use only facts from the provided files and cited sources.
4. Label uncertain or inferred information explicitly.
5. Keep each screen focused on one idea.
6. End with three common misunderstandings and three next steps.
7. Save the result as `eli5-explainer.html`.
Audience: $AUDIENCE
Topic: $ARGUMENTS
---
name: eli5-project
description: Explain an unfamiliar technical topic or project with a visual HTML artifact.
---
Explain the topic to a reader who has no prior knowledge.
Create a self-contained HTML artifact with large visuals and few words.
Requirements:
1. Start with a one-sentence explanation of what it is and why it matters.
2. Show the main flow before introducing details.
3. Use only facts from the provided files and cited sources.
4. Label uncertain or inferred information explicitly.
5. Keep each screen focused on one idea.
6. End with three common misunderstandings and three next steps.
7. Save the result as `eli5-explainer.html`.
Audience: $AUDIENCE
Topic: $ARGUMENTS
它比原版多解决了四个问题：事实来源、推断标记、固定落盘和下一步行动。至于颜色、卡片圆角和动画，仍然可以交给模型根据内容决定。
ELI5 和普通问答，有什么本质区别？
| 方式 | 适合解决的问题 | 优点 | 局限 |
|---|---|---|---|
| 普通问答 | 快速获得事实或说明 | 快、灵活 | 容易堆成大段文字 |
| ELI5 | 第一次建立概念框架 | 关系直观、阅读门槛低 | 容易过度简化 |
| grill-me | 把模糊方案问清楚 | 能发现遗漏和决策依赖 | 不负责视觉讲解 |
| 正式文档 | 精确记录规范和边界 | 可引用、可审计 | 学习门槛较高 |
ELI5 与 grill-me 都很短，却采用了不同策略：ELI5 规定最终表达形式，grill-me 规定对话推进方式。它们共同说明，Skill 的价值不一定来自步骤数量，而是能否抓住决定结果的关键约束。
使用 ELI5 前，要知道这些边界
1. “讲得简单”不等于“事实正确”
视觉页面很容易让人产生“看起来很完整，所以一定正确”的错觉。涉及版本、价格、法律、医疗、安全和线上事故时，必须回到原始资料核对。
2. 简化一定会损失细节
ELI5 适合建立第一张地图，不适合替代完整文档。建议先用 ELI5 理解主干，再阅读官方文档补充边界条件。
3. 代码库可能包含敏感信息
解释内部项目之前，要排除密钥、客户数据、生产配置和安全细节。只给 Agent 完成任务所需的最小目录权限。
4. 生成的 HTML 仍要检查
如果页面包含脚本、外链或可下载内容，发布前应检查网络请求、第三方资源、移动端布局和无障碍表现。不要把模型生成的 HTML 直接部署到正式站点。
5. 可视化页面可能比纯文本消耗更多 Token
模型不仅要解释概念，还要生成结构、样式和交互代码。简单问题没有必要每次都调用 ELI5；当关系复杂、需要培训或反复复用时，它的价值更高。
ELI5 与 Apito 如何配合？
ELI5 负责定义“模型应该怎样完成解释任务”，Apito 位于模型 API 接入层，负责团队使用模型时的 API Key、请求地址、可用模型、调用记录和成本观察。
如果 Claude Code 或其他 Agent 已经通过 Apito 完成模型配置，安装 ELI5 后通常不需要再为 Skill 单独申请一枚 Key。Skill 会使用当前 Agent 已配置的模型连接。
一个清晰的分层应该是：
用户问题
↓
ELI5 Skill：受众、目标、输出形式
↓
Claude Code / Codex / 其他 Agent：读取资料并执行任务
↓
Apito：模型 API 接入、模型选择、调用记录、成本观察
↓
生成 HTML 文件 → 人工校验 → 发布或归档
用户问题
↓
ELI5 Skill：受众、目标、输出形式
↓
Claude Code / Codex / 其他 Agent：读取资料并执行任务
↓
Apito：模型 API 接入、模型选择、调用记录、成本观察
↓
生成 HTML 文件 → 人工校验 → 发布或归档
Apito 不负责安装 Skill，也不会自动保证生成页面的事实准确性。团队仍需审查输入资料、Agent 权限和最终 HTML。
说明：Apito 是独立的第三方模型 API 接入服务，不代表 Anthropic；ELI5 是社区插件，不是 Apito 自研 Skill。
写在最后
ELI5 最值得借鉴的地方，不是“把所有回答都做成网页”，而是它只保留了真正影响结果的三条约束：读者从零开始、用视觉解释、减少文字。
过去我们写提示词，总担心模型不懂，于是把每一步都规定得越来越细。模型能力增强以后，另一种 Skill 设计方式开始变得可行：明确目标和不可违反的边界，让模型自行补齐实现细节。
当然，短并不天然代表好。任务越高风险、越需要稳定复现，就越要补充事实来源、权限、输出格式和验收标准。
最实用的做法是：先从 ELI5 的一句话开始。如果结果不稳定，再根据真实失败逐条增加约束，而不是一开始就写一份没人能维护的超长提示词。
FAQ
ELI5 是 Anthropic 官方插件吗？
不是官方维护插件。它被收录在 Anthropic 组织托管的社区插件市场镜像中，作者字段为 Thariq Shihipar。
安装 ELI5 后为什么找不到 /eli5？
先确认社区市场已成功添加、插件安装没有报错，并重启或开启新的 Claude Code 会话。如果使用的不是 Claude Code，则需要按照对应 Agent 的 Skill 发现和触发规则调用。
ELI5 可以读取整个项目吗？
能否读取取决于 Agent 当前拥有的文件权限。建议只开放相关目录，并在提示词中明确禁止读取密钥、用户数据和生产配置。
生成的 HTML 可以直接上线吗？
不建议。应先检查事实、脚本、外部请求、资源版权、移动端布局和无障碍表现，再进入正式发布流程。
ELI5 会额外消耗 API Key 吗？
它本身只是一份指令文件，不单独申请或存储 API Key。但执行任务会消耗当前 Agent 所配置模型的 Token 和调用额度。
所有主题都适合用 ELI5 吗？
不是。简单事实查询用普通问答更快；需要精确规范、完整论证或高风险决策时，应以正式文档和专业审核为准。
参考资料
如果你准备把 Skill 放进日常 Agent 工作流，可以从 Apito 配置统一的模型 API 接入，再用实际任务记录比较不同模型的生成质量、耗时和成本。
