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.

examplesgo-to-marketlead-source-rose.md

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

Rose Chart — Lead Sources by Volume and Win Rate (ECharts)

Best for: a single-period split where the "winner" should dominate visually, not just numerically Avoid when: the reader must compare slices precisely, or the values are close together Answers: which acquisition channels carry the pipeline, and how concentrated the mix is

{
  "color": ["#2b66c4", "#2f9e44", "#f3a33c", "#d1242f", "#7048e8", "#0f9b9b", "#c16f8a", "#7c5a3d"],
  "width": 760,
  "height": 520,
  "title": { "text": "Pipeline by Lead Source", "subtext": "Rose chart — radius encodes volume, so large channels are emphasised", "left": "left" },
  "legend": { "data": ["Reseller partners", "OEM partners", "Outbound", "Website", "Community", "Events"], "bottom": 0 },
  "series": [
    {
      "name": "Lead source",
      "type": "pie",
      "roseType": "radius",
      "radius": ["14%", "74%"],
      "center": ["50%", "52%"],
      "itemStyle": { "borderRadius": 6 },
      "label": { "show": true, "formatter": "{b}\n{d}%" },
      "labelLine": { "length": 10, "length2": 12 },
      "data": [
        { "value": 420, "name": "Reseller partners" },
        { "value": 310, "name": "OEM partners" },
        { "value": 240, "name": "Outbound" },
        { "value": 180, "name": "Website" },
        { "value": 120, "name": "Community" },
        { "value": 60, "name": "Events" }
      ]
    }
  ]
}

Data Shape

One row per slice: value drives both the sector angle and the petal length, name supplies the label. With roseType: "radius" the angle and the radius encode the same field, which is exactly why the chart is read as "big stays big".

Key Options

Option Effect
roseType: "radius" Both angle and radius follow the value — the classic Nightingale look
roseType: "area" Keeps the angle proportional to the value and only the radius moves; a gentler variant
radius: ["14%", "74%"] An inner radius leaves the centre free so labels do not collide with the smallest petals
itemStyle.borderRadius Rounds each petal; with dense mixes it keeps neighbouring petals legible
label.formatter: "{b}\n{d}%" Names the slice and its share on two lines with a built-in template — no callback needed

Pitfalls

  • ❌ Reading a rose like a normal pie → ✅ in the radius variant the angle is still proportional, but the area overstates large values; say so in the subtitle when the exaggeration is deliberate
  • ❌ Comparing near-equal slices → ✅ the eye cannot rank petals; use a bar chart when the ranking is the point
  • ❌ Two data items with the same name → ✅ they render as separate petals but collapse into one legend entry; split the names or merge the values
  • ❌ Many tiny slices plus roseType: "radius" → ✅ small values shrink into unreadable slivers; group them into "Other"

Alternatives

Variant Use instead
Precise ranking of the same channels comparison-bars.md
A flat share of a small total donut-channel-mix.md
Nesting the mix under a second dimension cloud-spend-nested-pie.md
<!-- source: ECharts option manual (series-pie roseType / radius / label) + the pie how-to page on rose charts -->

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