
能够生成丰富的HTML页面或幻灯片,用于图表、差异审查、计划审计、数据表和项目回顾
概览
请你的客服解释系统架构,审查差异,或将需求与计划进行比较。它不再是ASCII艺术和框图表格,而是生成一个独立的HTML页面,并在浏览器中打开。 https://github.com/user-attachments/assets/55ebc81b-8732-40f6-a4b1-7c3781aa96ec 每个编码代理在你要求图表时默认使用ASCII艺术。方框绘制字符、等宽对齐技巧、文本箭头。这对琐碎情况有效,但超过三格流程图的话就变得一团乱麻。 表格更糟。让客服把15个需求和一个计划对比,终端里会变成一堵管道和破折号的墙。数据确实存在,但读起来很痛苦。 这个技能解决了这个问题。真实的排版,暗/浅主题,带有缩放和平移的互动美人鱼图。没有构建步骤,除了浏览器之外没有依赖。 注意:Claude Code 将命名空间命令插件为 /visual-explainer:command-name。
概述(AI 翻译)
** 一个代理技能,可以将复杂的终端输出转化为你真正想阅读的样式化 HTML 页面。**
请你的客服解释系统架构,审查差异,或将需求与计划进行比较。它不再是ASCII艺术和框图表格,而是生成一个独立的HTML页面,并在浏览器中打开。
https://github.com/user-attachments/assets/55ebc81b-8732-40f6-a4b1-7c3781aa96ec
为什么
每个编码代理在你要求图表时默认使用ASCII艺术。方框绘制字符、等宽对齐技巧、文本箭头。这对琐碎情况有效,但超过三格流程图的话就变得一团乱麻。
表格更糟。让客服把15个需求和一个计划对比,终端里会变成一堵管道和破折号的墙。数据确实存在,但读起来很痛苦。
这项技能解决了这个问题。真实的排版、暗/浅主题、手绘图表,能动画并响应读者。正常技能使用没有构建步骤,也没有浏览器以外的依赖;可选的MCP和PPTX工具使用小的节点依赖。
本页由 AI 翻译,技术细节请以原文为准。
README
以下为原文 README 节选,完整内容请查看原文。
visual-explainer
An agent skill that turns complex terminal output into styled HTML pages you actually want to read.
Ask your agent to explain a system architecture, review a diff, or compare requirements against a plan. Instead of ASCII art and box-drawing tables, it generates a self-contained HTML page and opens it in your browser.
> draw a diagram of our authentication flow
> /diff-review
> /plan-review ~/docs/refactor-plan.md
https://github.com/user-attachments/assets/55ebc81b-8732-40f6-a4b1-7c3781aa96ec
Why
Every coding agent defaults to ASCII art when you ask for a diagram. Box-drawing characters, monospace alignment hacks, text arrows. It works for trivial cases, but anything beyond a 3-box flowchart turns into an unreadable mess.
Tables are worse. Ask the agent to compare 15 requirements against a plan and you get a wall of pipes and dashes that wraps and breaks in the terminal. The data is there but it’s painful to read.
This skill fixes that. Real typography, dark/light themes, hand-drawn diagrams that animate and respond to the reader. Normal skill use has no build step and no dependency beyond a browser; optional MCP and PPTX utilities use small Node dependencies.
Step through a state machine one event at a time: the route each event took lights up, jobs pile into queues and drain, and each step says why it happened (example).
Install
| Harness | Support | Install path / behavior |
|---|---|---|
| Claude Code | Marketplace plugin | Preserved marketplace shape with source at plugins/visual-explainer/ |
| Pi | Package metadata plus installer | package.json advertises the skill, prompts, and native visual_explainer tool with prepare and render actions; install-pi.sh installs copied skill/prompt resources for legacy manual installs |
| MCP hosts | Local stdio MCP server | visual-explainer-mcp exposes prepare and render tools, prompt templates, and read-only skill resources without starting an HTTP server |
| PPTX export | Best-effort static utility | visual-explainer-pptx converts simple HTML slide decks to .pptx; HTML remains the source of truth |
| Video export | Local renderer (needs ffmpeg, Chrome, and playwright-core, installed separately) |
/generate-video writes a video deck and visual-explainer-video records it to a 1080p MP4, frame by frame, narrated when a speech API key is set and captioned otherwise |
推荐工具
换一个关键词,或者移除筛选条件。
安装
npx skillfish add nicobailon/visual-explainer