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.

examplescomparison-and-selectionbuy-vs-build-comparison.md

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

Buy vs Build — Binary Comparison (Infographic)

Best for: an A/B choice where the reader needs a quick directional comparison rather than a weighted scoring model Avoid when: there are more than two options or the decision needs precise quantified criteria Answers: how the options differ at a glance, and what each one optimizes for

infographic compare-binary-horizontal-underline-text-vs
theme
  colorPrimary #2b66c4
  palette
    - #2b66c4
    - #2f9e44
    - #f3a33c
    - #d1242f
    - #7048e8
    - #0f9b9b
    - #c16f8a
    - #7c5a3d
data
  title Buy vs Build
  desc Decision frame for a new workflow automation capability
  compares
    - label Buy
      children
        - label Speed
          desc Faster launch with lower implementation effort
        - label Maintenance
          desc Vendor handles upgrades and baseline support
        - label Fit
          desc Limited customization around edge-case workflows
    - label Build
      children
        - label Control
          desc Full ownership of workflow logic and domain fit
        - label Maintenance
          desc Internal team owns upgrades and operational burden
        - label Risk
          desc Longer path to value and greater delivery uncertainty

Data Shape

Use compares with exactly two top-level items. Each side gets a short set of children that explain the trade-offs.

Key Options

Option Effect
compare-binary-horizontal-underline-text-vs Direct left/right A-vs-B framing
Two compares items Encodes a binary comparison without extra scoring machinery
children Holds the specific criteria or arguments under each side

Pitfalls

  • ❌ Trying to compare three or four options in a binary template → ✅ keep this pattern strictly A vs B
  • ❌ Long argumentative paragraphs per side → ✅ use short, decision-oriented criteria instead
  • ❌ Treating qualitative comparison as proof of the decision → ✅ this is framing, not a formal scorecard

Alternatives

Variant Use instead
SWOT-style strategic framing market-entry-swot.md
Quantified trade-off model Vega-Lite or HTML comparison table
One-page decision memo decision-comparison-card.md
<!-- source: AntV Infographic template reference (`compare-binary-horizontal-underline-text-vs`) + syntax docs for compares/children -->

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