Skip to content
Skills Library
Programming · Conversion & formats

visualize

/visualize

Turn a concept, codebase, flow, or comparison into a diagram instead of a wall of text — terminal-native ASCII (architecture, flowcharts, state machines, sequences, trees, comparison tables); mermaid only when output targets GitHub or a markdown viewer. Use when the user wants something drawn, mapped, or visualized rather than described in prose. Trigger phrases: "draw this", "diagram this", "visualize", "show me a diagram", "map this out", "flowchart", "architecture diagram", "sequence diagram", "state machine", "ascii diagram", "make this visual", "/empire-visual:visualize".

Repository
empire ↗
Licence
MIT
Last repository change
07.10.2026

Assessment and security

82/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content17 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
2
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 07.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Turn a concept, codebase, flow, or comparison into a diagram instead of a wall of text — terminal-native ASCII (architecture, flowcharts, state machines, sequences, trees, comparison tables); mermaid only when output targets GitHub or a markdown viewer. Use when the user wants something drawn, mapped, or visualized rather than described in prose. Trigger phrases: "draw this", "diagram this", "visualize", "show me a diagram", "map this out", "flowchart", "architecture diagram", "sequence diagram", "state machine", "ascii diagram", "make this visual", "/empire-visual:visualize".

Triggers from the description

draw thisdiagram thisvisualizeshow me a diagrammap this outflowchartarchitecture diagramsequence diagram
Original author description

Turn a concept, codebase, flow, or comparison into a diagram instead of a wall of text — terminal-native ASCII (architecture, flowcharts, state machines, sequences, trees, comparison tables); mermaid only when output targets GitHub or a markdown viewer. Use when the user wants something drawn, mapped, or visualized rather than described in prose. Trigger phrases: "draw this", "diagram this", "visualize", "show me a diagram", "map this out", "flowchart", "architecture diagram", "sequence diagram", "state machine", "ascii diagram", "make this visual", "/empire-visual:visualize".

How it works

SKILL.md has no level-two headings · 76 lines, 507 words

SKILL.md preview
---
name: visualize
description: >
  Turn a concept, codebase, flow, or comparison into a diagram instead of a wall of
  text — terminal-native ASCII (architecture, flowcharts, state machines, sequences,
  trees, comparison tables); mermaid only when output targets GitHub or a markdown
  viewer. Use when the user wants something drawn, mapped, or visualized rather than
  described in prose. Trigger phrases: "draw this", "diagram this", "visualize", "show
  me a diagram", "map this out", "flowchart", "architecture diagram", "sequence
  diagram", "state machine", "ascii diagram", "make this visual",
  "/empire-visual:visualize".
compatibility: Runs in any Agent Skills runtime (Claude Code, OpenAI Codex, and others). Self-contained: terminal-native ASCII, no subagents.
allowed-tools: Read, Grep, Glob
---

<section id="core">

**A diagram loads two cognitive channels; prose loads one.** Verbal and visual
information travel separate paths (dual-coding theory), and working memory saturates
fast (cognitive load theory). A labeled diagram lets a reader grasp structure at a
glance and hold it longer. This skill converts a thing-with-structure into the visual
that carries it best.

Scope: structure, flow, state, sequence, hierarchy, comparison, quantity. If the
answer has no structure — a single fact, a yes/no — do NOT force a diagram. Say it.

</section>

<section id="process">

1. **Identify what has structure.** Read the source if needed (`Read`/`Grep`/`Glob` a
   file, function, or directory). Find the entities and the relationships between them —
   that is what the diagram encodes.
2. **Match intent to format** (table below). One intent → one primary format. Do not mix
   three diagram types in one figure.
3. **Choose the render target.** Terminal/chat → ASCII. GitHub/PR/markdown viewer →
   mermaid is allowed. When unsure → ASCII (it renders everywhere).
4. **Draw it, then prune.** Apply the quality bar. Cut every element that carries no
   meaning.
5. **Add only the prose the picture cannot encode** — the _why_, a caveat, the next step.

</section>

<section id="format-by-intent">

| Intent                                | Format                             |
| ------------------------------------- | ---------------------------------- |
| Structure / architecture / layers     | ASCII box-drawing                  |
| File / module / type hierarchy        | Indented tree                      |
| Control flow / decisions / algorithm  | ASCII flowchart (boxes + arrows)   |
| State / lifecycle transitions         | ASCII state diagram                |
| Request path / call order             | Numbered sequence or `A → B → C`   |
| Options / trade-offs / feature matrix | Markdown table                     |
| Quantities / distribution / progress  | ASCII bars (`█████░░░`) or a table |

</section>

<section id="render-rules">

- MUST default to ASCII / Unicode box-drawing + Markdown tables. They render in
  agent terminal TUIs, IDE panels, and GitHub.
- MUST use a ` ```mermaid ` block ONLY when output targets GitHub, a PR, or a markdown
  viewer. The terminal TUI does NOT render mermaid — it prints the raw source. Never
  make mermaid the sole representation in a terminal reply. When both terminal and
  GitHub are in play, lead with ASCII; offer mermaid as an addition if asked.
- SHOULD keep box-drawing characters consistent within one figure: `┌ ┐ └ ┘ ├ ┤ ┬ ┴ ┼ │ ─`
  for boxes, `→ ← ↑ ↓` for flow.

</section>

<section id="quality-bar">

Badly built diagrams read as visual noise — worse than prose. Enforce:

- **Coherence** — exclude every element that does not carry meaning. Fewer nodes wins.
- **Spatial contiguity** — labels inside or directly beside what they label, never in a
  separate paragraph.
- **Size** — under ~15 nodes per figure. Bigger → split into layers or show the top
  level and drill down on request.
- **No redundancy** — do not restate in prose what the figure already shows.

</section>

<section id="templates">

For copy-ready ASCII shapes — architecture, tree, flowchart, state machine, sequence,
quantity bars — read `references/diagram-templates.md`.

</section>
Files in this package (2)
  • SKILL.md 4 KB
  • references/diagram-templates.md 2 KB

Versions

RepositoryScoreLicence
This page · marcoskichel/empire82MIT
cloudgeni-ai/opengeni100Apache-2.0
asgeirtj/system_prompts_leaks100CC0-1.0
amit429/understanding-map100MIT
asgeirtj/system_prompts_leaks100CC0-1.0
nathanvale/side-quest-marketplace100MIT
clawnify/greybeard100MIT
HaizhuAI/Zkali100Apache-2.0
vellum-ai/vellum-assistant100MIT

Database snapshot: 13.11.2026 · package version 67433a802a15 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100visual-communication
    Communicate systems and flows visually using Mermaid (flowchart, sequence, state, ER, class), the C4 model, and diagram-as-code. Use when the user asks to draw a flow, sequence diagram, state machine, ER diagram, C4 model, architecture diagram, or wants Mermaid code for a…
  • 100diagramming
    Creates Mermaid and ASCII diagrams for flowcharts, architecture, ERDs, state machines, mindmaps, and more. Use when user mentions diagram, flowchart, mermaid, ASCII diagram, text diagram, terminal diagram, visualize, C4, mindmap, architecture diagram, sequence diagram, ERD, or…
  • 100mermaid-diagramming
    Create Mermaid diagrams using the project's blue-gray theme. Use whenever the user asks to draw a diagram, create a flowchart, visualize a process, document architecture, or add any Mermaid diagram to a markdown file. Trigger on phrases like "draw a diagram", "create a…
  • 100external-diagram-mermaid-generate
    Salesforce architecture diagrams using Mermaid with ASCII fallback. Use this skill when generating text-based diagrams for Salesforce architecture, OAuth flows, ERDs, integration sequences, or Agentforce structure. TRIGGER when: user says \"diagram\", \"visualize\", \"ERD\", or…
  • 90doncheli-diagram
    Auto-generate Mermaid or C4 diagrams from code analysis. Activate when user mentions "diagram", "mermaid", "architecture diagram", "C4", "class diagram", "sequence diagram", "ERD", "flowchart", "visualize code".
  • 85diagrams
    Router for the diagrams plugin — pick the right diagram format and dispatch to its skill. Routes to ascii-art (text/box-drawing diagrams), mermaid (flowcharts, sequence, class, state, ER, gantt), or wardley (Wardley maps in markdown). Use when the user says "draw a diagram",…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.