Index of every page on this site: llms.txt
All skills
markdown-viewer avatar

/documd-visuals

@2672b69
by Markdown Viewermarkdown-viewer/skills3.4k stars
192
Run it yourself

Create text-driven visuals in Markdown: charts, diagrams, cards, architecture and page layouts. Charts and analytical views (bar, line, pie, heatmap, correlation, regression); reliability and operations (latency, incident, throughput, cycle time, OKR, standup, on-call); product and finance (funnel, retention, revenue, budget); process and workflow (approval, BPMN); software design and behaviour (class, state machine, sequence, C4); dependencies and impact (dependency graph, ER, causality); system architecture as HTML (layer stack, wings, zones, topology, service catalogue, request paths); infrastructure (cloud, Kubernetes, ETL, network, security, IAM, compliance); governance and people (ArchiMate, org chart, hiring); knowledge and planning (mind map, roadmap, Gantt, migration); documents (comparison, SWOT, memo, policy, catalogue, case study). Use when a document needs a diagram, chart or card. Figures render live. Not for slide decks or math notation. Not recommended: mermaid / canvas / drawio / dot.

Use this Skill: https://skilld.dev/gh/markdown-viewer/skills/documd-visuals

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

examplesknowledge-and-outlinetopic-mindmap.md

≈633 tokens on demand. Your agent reads this file only when SKILL.md points to it.

Topic Mind Map

Best for: decomposing one topic into branches when there is no strict order or hierarchy layer Avoid when: the structure is a real org chart or a work breakdown with owners (use WBS) or the nodes need free positioning (use an HTML/CSS diagram) Answers: what the topic consists of, at a glance

@startmindmap
title Platform Modernisation — Topic Map

* Platform Modernisation
** Drivers
*** Cost per transaction
*** Release lead time
*** Audit findings
** Current state
*** Monolith (Java 11)
*** Nightly batch integration
*** Manual release runbook
** Target state
*** Service-oriented core
*** Event-driven integration
*** Infrastructure as code
** Workstreams
*** Domain decomposition
*** Data migration
*** Observability
*** Security hardening
** Risks
*** Dual-run cost
*** Data reconciliation
*** Skill gaps
** Success metrics
*** Lead time < 1 day
*** Change failure rate < 10%
*** Cost per transaction -30%
left side
** Stakeholders
*** Product
*** Engineering
*** Finance
*** Compliance
@endmindmap

Key Options

Syntax Effect
@startmindmap … @endmindmap Mind map mode (independent from @startuml)
* / ** / *** Depth levels — indentation is expressed by asterisk count, not spaces
left side Everything after it is placed on the left branch (visual balance / compare two halves)
*: multi-line Multi-line rich-text node when a single word is not enough
title Diagram title

Data Shape

A tree with 4–7 top-level branches and 2–4 children each. More than that and the map stops being scannable — split it into two maps (current state / target state).

Pitfalls

  • ❌ Every branch at a different depth → ✅ keep sibling depth consistent; uneven trees read as unfinished
  • ❌ Sentences in nodes → ✅ node text is a noun phrase; put explanation in the prose around the diagram
  • ❌ Using a mind map for a process → ✅ mind maps have no order; use an activity diagram when sequence matters
  • ❌ Forgetting left side → ✅ for 5+ top branches, split them left/right instead of a tall one-sided tree

Alternatives

Variant Use instead
Work breakdown with owners and deliverables work-breakdown-structure.md
Concept relationships with cross-links dependencies-and-relations/relationship-network-neato.md
Ordered progression of stages An infographic sequence template or sequence-*
<!-- source: draw-uml mindmap parser (L1, 27 fixtures) -->

Source: SKILL.md on GitHub

Skill behaviors

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

Third-party checks

No alerts16d3 checks · Risk SAFE
  • Gen Agent Trust Hub16d

    This skill provides documentation and examples for creating various visuals in Markdown using engines like ECharts, Vega, PlantUML, and HTML. It recommends using the vendor-owned @markdown-viewer/documd CLI tool for document conversion and verification. The skill itself contains no executable code or malicious patterns.

  • Socket16d

    No alerts

  • Snyk16d

    Risk: LOW · No issues

Provenance

Signed by skilld at 2672b69. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 2 weeks ago.

Activeupdated 3 weeks ago

Capability

Other metadata
compatibility
Figures are text in the Markdown — fenced blocks or bare HTML — and the host viewer renders them live: nothing to pre-render, build or install. Export to html / epub / docx / pdf is optional and needs Node 18+ and Chrome/Chromium, via `npx @markdown-viewer/documd`.

README badge

README badge for markdown-viewer/skills