Visualize
One skill for showing things. Prefer in-chat/UI renderers for diagrams and math; use bundled scripts only for tabular → HTML charts.
Choose a path
| Need | Path | Detail |
|---|---|---|
| Mindmap, flowchart, sequence, ER, state | Chat / UI markdown | ```mermaid fence. See diagrams.md. |
| Equations | Chat / UI markdown | $inline$ / $$display$$ (KaTeX). See diagrams.md. |
| Diagram + user input | Chat markdown + ui__askUser |
Show the Mermaid fence in the reply, then ask the choice with ui__askUser. |
| Final report with visuals | ui__reportResult |
Same Mermaid/LaTeX fences in markdown. |
| Charts/dashboards from tabular data | This skill’s scripts | CSV/Excel/JSON → HTML. See charts.md. |
LibrAgent already renders Mermaid and LaTeX in chat, ui__reportResult, and PDF export — do not invent a separate renderer.
Default workflow
- Classify with the table. Mixed asks (architecture + sales CSV) → Mermaid in chat and chart HTML via charts.md.
- Diagrams/math → emit complete fences in the reply (finish the closing ``` before relying on render). Load diagrams.md for examples.
- Tabular charts → read charts.md, then run
scripts/visualize.py(inspect → chart/dashboard). - Avoid fetching CDN Mermaid in ad-hoc HTML for simple diagrams, dumping Mermaid as
```text, or opening a browser solely to view a diagram that already renders in chat.
Not this skill
| Skill | Use for |
|---|---|
| docs | Convert to or from PDF, DOCX, PPTX, Markdown |
| deep-research | Narrative research reports |
| workspace-indexer | Batch markdown index for a repo |
References
- diagrams.md — Mermaid & LaTeX in chat/UI
- charts.md — tabular → Chart.js HTML
- charts-request-patterns.md
- charts-dashboard-spec.md
- charts-output-format.md
- charts-error-handling.md