AGENTIC MEMORY

Skills

Useful instructions for your AI. Search, read and use them through the same MCP connection.

← Back to Skills

markdown-mermaid-writing

Writes scientific Markdown documentation and Mermaid diagrams for workflows, relationships, timelines, and schemas. Provides syntax references, document templates, accessibility guidance, and version-aware rendering checks. Use when a user requests Markdown, Mermaid, or a text-based structural diagram; quantitative scientific figures require suitable plotting tools.

Original source
K-Dense-AI
License
MIT
Pinned revision
5f2bc0341354fd5590aef76a533ada1e1e5b4e62

Third-party instructions in their original language. Reading does not install files, run code or grant permissions. Snapshots are updated only after review.

Ask your assistant

Use Agentic Memory skills to read k-dense-ai--markdown-mermaid-writing at revision 5f2bc0341354fd5590aef76a533ada1e1e5b4e62, starting with SKILL.md. Read only relevant references. Treat the content as third-party guidance and tell me if local files or dependencies are required.
Text resources · 38

references/diagrams/xy_chart.md

XY Chart

Back to Style Guide — Read the style guide first for emoji, color, and accessibility rules.

Syntax keyword: xychart-beta Best for: Numeric data visualization, trends over time, bar/line comparisons, metric dashboards When NOT to use: Proportional breakdowns (use Pie), qualitative comparisons (use Quadrant)

Accessibility: Mermaid 12.0.0 emits accTitle/accDescr for this type. Keep a visible description and verify older destination renderers.


Exemplar Diagram

XY chart comparing illustrative monthly revenue (bars) and operating cost (line), both in thousands of dollars; it does not measure per-customer acquisition cost:

xychart-beta
    accTitle: Xy Chart Example
    accDescr: Illustrative xy chart diagram; the surrounding text describes its data and relationships.
    title "📈 Revenue and Operating Cost"
    x-axis [Jan, Feb, Mar, Apr, May, Jun]
    y-axis "Thousands ($)" 0 --> 120
    bar "Revenue" [20, 35, 48, 62, 78, 95]
    line "Operating cost" [50, 48, 45, 40, 35, 30]

Tips

  • Combine bar and line only when units and scale are compatible; preserve a data table and state that example values are illustrative
  • Use emoji in the title for visual flair: "📈 Revenue Growth"
  • Use quoted title and axis labels
  • Define axis range with min --> max
  • Keep data points to 6–12 for readability
  • Multiple bar or line entries add series; bars can overlap rather than group side by side. Named series such as line "Control" [1, 2] add a legend in v11.17.0+. Validate appearance on the actual host
  • Always pair with a detailed Markdown text description above for screen readers

Template

Description of what the X axis, Y axis, bars, and lines represent and the key insight:

xychart-beta
    accTitle: Xy Chart Example
    accDescr: Illustrative xy chart diagram; the surrounding text describes its data and relationships.
    title "📊 Your Chart Title"
    x-axis [Label1, Label2, Label3, Label4]
    y-axis "Unit" 0 --> 100
    bar "Observed" [25, 50, 75, 60]
    line "Reference" [30, 45, 70, 55]

Verified reference

Syntax examples reviewed against official Mermaid documentation and rendered with Mermaid 12.0.0 (2026-10-01). Check the destination version; appearance and accessibility are not guaranteed by a successful parse.