PluginInstalls cleanly

Draw 44 kinds of diagrams

illustration-tools

Sanduq's Illustrate plugin draws 44 diagram types as editable HTML with inline SVG in your project's colours and fonts, with SVG, PNG or GIF export.

Works with
Claude Code, Codex CLI
Good for
Graphic designers, Web developers, Daily work and research

What it does

Sanduq Illustrate is a plugin that draws technical and product diagrams for your docs: architecture maps, sequence charts, flowcharts, ER diagrams, timelines, heatmaps and many more, forty-four types in total. Output is one HTML file with inline SVG that you open in a browser and can edit. When you ask, it exports SVG, PNG, animated SVG or GIF. Technical-color diagrams also get copy, PNG and PDF buttons in the page.

Before drawing, it resolves a project theme file (.github/illustration-theme.yml) so colours and fonts match your docs. If that file is missing, it asks you to pick Cobalt Porcelain, Emerald Mist, Sanduq Classic or a custom theme, then writes it. Local Python scripts check geometry, arrows and style on each diagram before you get it.

It can also redraw an existing draw.io, Mermaid or Excalidraw file in your theme. The Claude Code install goes through the Sanduq marketplace, which pins a release tag of the skills repository.

Example prompts

  • "/illustration-tools:illustrate Draw a sequence diagram of refund approval: the operator approves, the booking API checks access and records the decision, and the payment provider settles."
  • "Draw an architecture diagram of our web app, API and database."
  • "Redraw docs/flow.mmd in our project theme."
  • "Export it as SVG."

How to install

/plugin marketplace add samykabu/sanduq
/plugin install illustration-tools@sanduq

How to use it

Ask for a diagram in plain words, or call /illustration-tools:illustrate. Example: "Draw an architecture diagram of our API and database".

Check it works

After installing, start a new session and run /illustration-tools:illustrate with a short request. It should resolve the theme (and ask you to pick one if .github/illustration-theme.yml is missing), state the diagram type and size it plans, and then write one HTML file you can open in a browser.

Common problems

Other assistants

  • Codex: npx skills add samykabu/sanduq-skills --skill illustrate -a codex installs into the project under .agents/skills/; add -g to install for your user. Start a new session and call it with $illustrate — https://github.com/samykabu/sanduq-skills
  • Gemini CLI: no Gemini route in the sanduq-skills README (checked 2026-11-06)

What to watch out for

  • The skill sets no disable-model-invocation and its description says to use it on any draw, diagram or chart request even without the word illustrate, so it can start on its own in Claude Code and Codex
  • Before drawing, it runs scripts/illustration_theme.py; if .github/illustration-theme.yml is missing it writes one (in chat it asks you for a theme first; init --non-interactive writes Cobalt Porcelain light)
  • Writes the diagram as an .html file in your project and runs local Python checkers on it (verify-geometry.py, self_check.py, per-type verify scripts); illustration_theme.py apply rewrites that file in place
  • Export is manual: export_diagram.py writes .svg, .png, animated .svg or .gif next to the diagram and lists every file it writes. PNG and GIF need Playwright with Chromium (GIF also Pillow); Python 3.10+ for themes and SVG
  • Diagrams can load Google Fonts when viewed; technical-color diagrams load html2canvas 1.4.1 and jsPDF 2.5.2 from cdn.jsdelivr.net (pinned with SRI hashes) for their copy, PNG and PDF buttons
  • The hand-drawn style needs Node 18+ and npm ci with network access in the skill folder (jsdom, roughjs, svg-pathdata)
  • THIRD_PARTY_NOTICES.md: parts of Illustrate derive from Cathryn Lavery's MIT work; bundled icons include Tabler Icons (MIT), Simple Icons (CC0), log-z/logos (MIT) and Devicon (MIT)
  • Marketplace install pulls a pinned git-subdir from samykabu/sanduq-skills (tag illustration-tools-v3.7.1, commit 150f808); the marketplace lives in samykabu/sanduq. Both repos were created on 2026-11-06
  • This plugin ships no hooks and no MCP server; only progress-report in the sibling agent-tools plugin installs hooks

Licence and author

Licence
MIT
Author
Samy K. Abushanab (samykabu)
Source code
github.com/samykabu/sanduq-skills

How we tested it

We installed it on an empty test computer on 6 Nov 2026. Installed and started in a clean test system. Not yet used in a real AI session.

Test level

Not yet used on real work.

Technical details of the test
Date
6 Nov 2026
Method
Intake sandbox run on 2026-11-06 in a clean container with no account: cloned the repository and checked its skill, agent and plugin files; added the samykabu/sanduq marketplace and installed illustration-tools@sanduq with the Claude Code command line (plugin.json 3.7.1, commit 150f808).

Checked again on 6 Nov 2026

Alternatives

  • Diagram Design — Cathryn Lavery's skill for one-file HTML diagrams; parts of Illustrate derive from her MIT work
  • stack-diagram — a diagram of your app's services with their official logos, as HTML or PNG
  • Next AI Draw.io — draws diagrams on a live draw.io page that you can also edit by hand

FAQ

  • Q: Does it call an image-generation API? A: No. Diagrams are built as HTML and SVG by the assistant and checked by local scripts; the skill says it is not for photos or AI raster images. Viewing a diagram can load Google Fonts, and technical-color diagrams load two export libraries from a CDN.
  • Q: Is the whole Sanduq suite required? A: No. You can install only illustration-tools@sanduq. The sibling plugins dev-tools and agent-tools cover manuals, wiki publishing, task delegation, progress reports and planning.
  • Q: What licence covers the icons? A: The repo is MIT; THIRD_PARTY_NOTICES.md lists MIT and CC0 icon sources whose notices must travel with copies.

Sources

  • github.com/samykabu/sanduq-skills
  • github.com/samykabu/sanduq-skills/blob/150f808bcd44456a1f9f8378858cae1dc0cccd38/skills/illustration-tools/.claude-plugin/plugin.json
  • github.com/samykabu/sanduq-skills/blob/150f808bcd44456a1f9f8378858cae1dc0cccd38/THIRD_PARTY_NOTICES.md
  • github.com/samykabu/sanduq/blob/835522e7056de10857048bd1e55107fb9377f7e0/.claude-plugin/marketplace.json
  • github.com/samykabu/sanduq-skills/blob/150f808bcd44456a1f9f8378858cae1dc0cccd38/skills/illustration-tools/skills/illustrate/SKILL.md
  • github.com/samykabu/sanduq-skills/blob/150f808bcd44456a1f9f8378858cae1dc0cccd38/skills/illustration-tools/skills/illustrate/scripts/export_diagram.py