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.

examplesbusiness-reportingsustainability-goals-progress.md

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

Sustainability Goals Progress — Commitments With Rings (Infographic)

Best for: a public or internal page showing progress against sustainability commitments Avoid when: commitments are measured in different units that need a table Answers: each goal, its target year, and how far the organisation has moved

infographic list-grid-circular-progress
theme
  colorPrimary #2b66c4
  palette
    - #2b66c4
    - #2f9e44
    - #f3a33c
    - #d1242f
    - #7048e8
    - #0f9b9b
    - #c16f8a
    - #7c5a3d
data
  title Climate Commitments
  desc Progress against 2030 targets
  lists
    - label Renewable electricity
      value 92
    - label Fleet electrification
      value 48
    - label Water intensity
      value 74
    - label Supplier disclosure
      value 31

Data Shape

lists where each item carries a numeric value — the share of the target, 0–100. The ring prints it in the centre (92%), so the label names the goal, not the metric, and the baseline year belongs in the page desc. ⚠️ desc is not rendered by this item: a percentage written there shows up as 0% in the ring.

Key Options

Option Effect
infographic list-grid-circular-progress Rings with labels beneath — reads as a scoreboard
value 92 The ring's share, 0–100. It is the only thing the ring can draw
list-grid-progress-card Bar form; easier when values differ in magnitude
list-grid-badge-card Drop the ring and keep the text if progress is qualitative

Pitfalls

  • ❌ Progress written as text (desc 92% of target) → ✅ value 92; the item renders no description, so the ring silently reads 0%
  • ❌ Baseline missing → ✅ "% of target" means nothing without the baseline year; state it in the title
  • ❌ Overstating progress → ✅ disclose method in the surrounding text, not the diagram
  • ❌ Eight commitments → ✅ pick the ones with governance; the rest are marketing claims

Alternatives

Variant Use instead
Goal progress inside one team onboarding-task-progress.md
Adoption trend over time feature-adoption-trend.md
Company-wide metric board leadership-metric-board.md
<!-- source: AntV Infographic syntax docs + template list (`list-grid-circular-progress`, item `circular-progress`: `label` + numeric `value`) -->

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