Brilliant Visualizer — AI skill for Claude Code

Brilliant Visualizer

An AI agent skill that analyzes article content and automatically generates matching illustrations — diagrams, architecture charts, AI images, stock photos, and infographics.

Why

Writing a good article is half the job. The other half is finding or creating the right visuals for each section. This skill does the second half: it reads your article, identifies where illustrations would help, picks the best generation method for each, and produces them.

It works as a standalone skill or as a pipeline stage between [great-writer](https://github.com/d-wwei/great-writer) (writing) and [typeset](https://github.com/d-wwei/typeset) (formatting). Compatible with any AI agent that supports skills — Claude Code, Codex, Gemini CLI, and others.

Quick Start

1. Copy the skill to your agent's skills directory:

# Claude Code
cp -r brilliant-visualizer ~/.claude/skills/

# Codex / other agents
cp -r brilliant-visualizer ~/.agents/skills/

1. Use it:

visualize path/to/article.md

1. Review the illustration plan, confirm, and let it generate.

How It Works

Two steps: **Analyze → Generate**.

**Step 1 — Analyze.** The skill scans your article and produces an illustration plan:

#	Location	Type	Engine	Description	Priority
1	After title	Cover	ai-image	Tech-style concept art	Required
2	After §2	Architecture	mermaid	Microservice topology	Required
3	After §5	Comparison	html-render	Performance metrics	Suggested

You can edit, remove, or add entries before proceeding.

**Step 2 — Generate.** For each confirmed entry, the skill loads the right engine, generates the visual, and inserts it into your Markdown.

Engines

Engine	What it does	Tool needed
mermaid	Flowcharts, sequence diagrams, ER diagrams, state charts, gantt, mindmaps, pie charts	@mermaid-js/mermaid-cli