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.

examplesincident-managementtree-support-routing.md

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

Tree — Support Routing Hierarchy (ECharts)

Best for: a single rooted hierarchy where the reader needs to understand structure and branching depth Avoid when: nodes can have multiple parents, the structure is mostly quantitative, or the message is dependency density rather than hierarchy Answers: how the hierarchy is organised, where branches split, and which items belong under each parent

{
  "color": ["#2b66c4", "#2f9e44", "#f3a33c", "#d1242f", "#7048e8", "#0f9b9b", "#c16f8a", "#7c5a3d"],
  "width": 1120,
  "height": 460,
  "title": { "text": "Support Routing Tree", "subtext": "Tiered ownership from intake to specialist teams", "left": "left" },
  "series": [
    {
      "type": "tree",
      "top": 96,
      "left": 80,
      "bottom": 36,
      "right": 240,
      "orient": "LR",
      "symbol": "emptyCircle",
      "symbolSize": 8,
      "label": { "position": "right", "verticalAlign": "middle", "align": "left", "fontSize": 11 },
      "leaves": { "label": { "position": "right", "align": "left", "fontSize": 11 } },
      "lineStyle": { "curveness": 0.45 },
      "expandAndCollapse": false,
      "initialTreeDepth": -1,
      "data": [
        {
          "name": "Support intake",
          "children": [
            {
              "name": "Account issues",
              "children": [
                { "name": "Password reset" },
                { "name": "SSO / login" }
              ]
            },
            {
              "name": "Billing issues",
              "children": [
                { "name": "Invoice query" },
                { "name": "Refund request" }
              ]
            },
            {
              "name": "Platform incidents",
              "children": [
                { "name": "Checkout failure" },
                { "name": "Search degradation" }
              ]
            }
          ]
        }
      ]
    }
  ]
}

Key Options

Option Effect
orient: "LR" Uses horizontal reading order, which fits operational trees better than a tall top-down layout
expandAndCollapse: false Keeps the static export deterministic; no branch depends on interaction to be visible
initialTreeDepth: -1 Expands the full hierarchy from the start
label vs leaves.label Lets parent and leaf labels align differently for cleaner reading
lineStyle.curveness Softens branches so siblings are easier to visually separate

Data Shape

One nested object tree under data[0], where every node may have a children array. This chart assumes every node belongs to exactly one parent.

Pitfalls

  • ❌ Using a tree for a graph with shared children → ✅ trees require one parent per node; use graph for many-to-many links
  • ❌ Depending on collapsed branches → ✅ static exports must show the full intended structure up front
  • ❌ Very deep trees in a narrow frame → ✅ switch to a table or split the hierarchy into several charts
  • ❌ Quantitative comparisons hidden in node text → ✅ if numbers are the message, use bars or treemaps instead

Alternatives

Variant Use instead
Many-to-many routing graph or sankey
Quantitative hierarchy treemap or sunburst
Process flow with hand-offs plantuml workflow / swimlane examples
<!-- source: ECharts option manual (series-tree) + examples gallery tree family -->

Source: SKILL.md on GitHub

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.

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

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
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