
nicobailon/visual-explainer
Developer toolsЭта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал
Навык агента, который генерирует богатые HTML-страницы или слайды для диаграмм, дифференциальных обзоров, аудитов планов, таблиц данных и обзоров проектов
Обзор
Попросите агента объяснить архитектуру системы, рассмотреть различие или сравнить требования с планом. Вместо ASCII-графики и таблиц с рисованием коробок он генерирует автономную HTML-страницу и открывает её в браузере. https://github.com/user-attachments/assets/55ebc81b-8732-40f6-a4b1-7c3781aa96ec Каждый программный агент по умолчанию использует ASCII-арт, когда вы просите диаграмму. Символы для рисования коробок, лайфхаки по выравниванию монопространства, текстовые стрелки. Это работает для мелких случаев, но всё, что выходит за рамки блок-схемы из трёх коробок, превращается в неразборчивый бардак. Таблицы — ещё хуже. Попросите агента сравнить 15 требований с планом — и вы получите стену из труб и тире, которая обмотывает и ломается в терминале. Данные есть, но читать их тяжело. Этот навык это исправляет. Настоящая типографика, темы/светлые темы, интерактивные диаграммы русалок с масштабированием и панорамированием. Нет шага сборки, нет зависимостей, кроме браузера. Примечание: Плагины Claude Code используют команды пространства имён как /visual-explainer:command-name.
Обзор (машинный перевод)
Навык агента, который превращает сложные терминальные выводы в стилизованные HTML-страницы, которые вы действительно хотите прочитать.
Попросите агента объяснить архитектуру системы, рассмотреть различие или сравнить требования с планом. Вместо ASCII-графики и таблиц с рисованием коробок он генерирует автономную HTML-страницу и открывает её в браузере.
https://github.com/user-attachments/assets/55ebc81b-8732-40f6-a4b1-7c3781aa96ec
Почему
Каждый программный агент по умолчанию использует ASCII-арт, когда вы просите диаграмму. Символы для рисования коробок, лайфхаки по выравниванию монопространства, текстовые стрелки. Это работает для мелких случаев, но всё, что выходит за рамки блок-схемы из трёх коробок, превращается в неразборчивый бардак.
Таблицы — ещё хуже. Попросите агента сравнить 15 требований с планом — и вы получите стену из труб и тире, которая обмотывает и ломается в терминале. Данные есть, но читать их тяжело.
Этот навык это исправляет. Настоящая типографика, темы/светлые темы, нарисованные от руки диаграммы, которые анимируют и реагируют на читателя. Обычное использование навыков не имеет шага сборки и не зависит от браузера; опциональные утилиты MCP и PPTX используют небольшие зависимости от узлов.
Эта страница переведена автоматически. Технические детали смотрите в оригинале.
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