visual-explainer

Generate self-contained HTML pages that visually explain systems, code changes, plans, and data.

1|Updated May 13, 2026
One-click install
npx skills add https://github.com/coolrobertj/Agency-Cowork --skill visual-explainer-coolrobertj
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: visual-explainer
Source: https://github.com/coolrobertj/Agency-Cowork/tree/main/skills/visual-explainer/skills/visual-explainer
Command: npx skills add https://github.com/coolrobertj/Agency-Cowork --skill visual-explainer-coolrobertj

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Technical explanations delivered as plain text or ASCII tables are hard to read and easy to misinterpret. This Skill turns architecture descriptions, diffs, plans, and tabular data into styled, self-contained HTML pages that open directly in the browser. ## Core Features & Use Cases - Diagram Generation: Produces architecture diagrams, flowcharts, sequence diagrams, ER diagrams, state machines, mind maps, and C4 views using CSS flow diagrams or themed Mermaid. - Review Workflows: Includes commands for visual diff review, plan review against the codebase, project recaps, and fact-checking documents against actual code. - Proactive Table Rendering: Automatically converts any ASCII table with 4+ rows or 3+ columns into a styled HTML table page instead of terminal output. - Use Case: After reviewing a pull request, ask for a visual diff review and receive an HTML page with an architecture comparison, risk assessment, and styled code references that you can share with your team. ## Quick Start Ask your agent to generate a visual architecture diagram of the current project as an HTML page and open it in the browser.

Frequently Asked Questions about visual-explainer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate a visual architecture diagram as HTML?

Describe the system you want explained and ask for a visual diagram. The skill builds a self-contained HTML page using CSS flow diagrams with bordered nodes and SVG arrows, then opens it in your browser and gives you the file path.

When should I use Mermaid versus CSS flow diagrams?

Use CSS flow diagrams for architecture diagrams where nodes carry labels and descriptions, since they adapt to light and dark mode. Use Mermaid for flowcharts with branching, sequence diagrams, ER diagrams, and state machines that need automatic edge routing.

Can the generated HTML pages be shared with my team?

Yes. The share command deploys the generated HTML page to Vercel and returns a live URL. Pages are self-contained single files, so you can also send the HTML file directly.

Does the visual explainer support dark mode?

Yes. Pages define palettes with CSS custom properties in :root and override them under prefers-color-scheme media queries, so the same file renders correctly in both light and dark mode.

Why does the skill replace ASCII tables with HTML pages?

ASCII box-drawing tables with 4+ rows or 3+ columns are hard to scan in a terminal. The skill renders them as semantic HTML tables with sticky headers, alternating rows, and status indicators, then opens the page in the browser automatically.