nicobailon/visual-explainer

Agent skill that generates rich HTML pages or slide decks for diagrams, diff reviews, plan audits, data tables, and project recaps

What it solves

It replaces unreadable ASCII art and monospace tables in terminal-based AI agents with styled, self-contained HTML pages. This solves the problem of complex diagrams, architecture flows, and large data comparisons becoming unreadable when rendered as plain text in a console.

How it works

It acts as an agent skill that generates HTML output instead of text. It supports interactive Mermaid diagrams with zoom and pan, dark/light themes, and professional typography. The project can be integrated as a plugin for various AI harnesses (like Claude Code, Cursor, and Pi) or as a local stdio MCP (Model Context Protocol) server that exposes rendering tools to the agent.

Who it’s for

Developers using AI coding agents who need to visualize system architectures, review code diffs, or compare complex requirements without leaving their workflow.

Highlights

  • Multi-Harness Support: Compatible with Claude Code, Cursor, Pi, Antigravity CLI, Codex CLI, and OpenCode.
  • Interactive Visuals: Uses Mermaid for diagrams that support zooming and panning.
  • MCP Integration: Provides a local MCP server for rendering HTML and quick JSON specs.
  • Zero Build Step: Basic skill usage requires no build process and only a web browser for viewing.

Related

  • Project
  • Project
  • Project
  • Project
  • Project