NV

nicobailon/visual-explainer

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る

1.1万 stars 品質 89 トレンド 70MIT

図、差分レビュー、計画監査、データ表、プロジェクト概要のための豊富なHTMLページやスライドデッキを生成するエージェントスキル

概要

エージェントにシステムアーキテクチャの説明を求めたり、差分を確認したり、要件と計画を比較してもらいましょう。ASCIIアートやボックス図面表の代わりに、自己完結型のHTMLページを生成し、ブラウザで開きます。 https://github.com/user-attachments/assets/55ebc81b-8732-40f6-a4b1-7c3781aa96ec すべてのコーディングエージェントは、図を求められるとASCIIアートをデフォルトで使います。ボックス描画の文字、単スペースのアライメントハック、テキスト矢印。些細なケースには使えますが、3ボックスのフローチャートを超えると読めない混乱になります。 テーブルはさらに悪いです。担当者に15の要件をプランと比較してもらうと、ターミナル内でパイプやダッシュの壁が巻きつき壊れてしまいます。データはありますが、読むのが苦痛です。 このスキルがそれを解決します。リアルなタイポグラフィ、暗い/明るいテーマ、ズームとパンが使えるインタラクティブなマーメイド図。ビルドステップもなく、ブラウザ以外の依存関係もありません。 注:Claude Codeは名前空間コマンドを/visual-explainer:command-nameとしてプラグインします。

概要(AI 翻訳)

複雑なターミナル出力を実際に読みたいスタイル付きのHTMLページに変換するエージェントスキル。

エージェントにシステムアーキテクチャの説明を求めたり、差分を確認したり、要件と計画を比較してもらいましょう。ASCIIアートやボックス図面表の代わりに、自己完結型のHTMLページを生成し、ブラウザで開きます。

https://github.com/user-attachments/assets/55ebc81b-8732-40f6-a4b1-7c3781aa96ec

なぜ

すべてのコーディングエージェントは、図を求められるとASCIIアートをデフォルトで使います。ボックス描画の文字、単スペースのアライメントハック、テキスト矢印。些細なケースには使えますが、3ボックスのフローチャートを超えると読めない混乱になります。

テーブルはさらに悪いです。担当者に15の要件をプランと比較してもらうと、ターミナル内でパイプやダッシュの壁が巻きつき壊れてしまいます。データはありますが、読むのが苦痛です。

このスキルはそれを解決します。リアルなタイポグラフィ、暗色・明るいテーマ、読者に反応しアニメーションする手描き図。通常のスキル使用にはビルドステップがなく、ブラウザ以外の依存関係はありません。オプションのMCPやPPTXユーティリティは小さなNode依存関係を利用します。

このページは 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
GitHub で README 全文を見る

推奨ツール

別のキーワードを試すか、フィルタを外してください。

インストール

npx skillfish add nicobailon/visual-explainer
MCP 初心者?mcpskill.org のガイドから始めましょう →