# imxv/Pretty-mermaid-skills

AI Agent Skill to generate and render beautiful Mermaid diagrams as SVG or terminal ASCII — 15 themes, 6 diagram types, batch CLI, no browser.

Repository: https://github.com/imxv/Pretty-mermaid-skills
Canonical: https://ross.abutalabs.com/products/pretty-mermaid-skills
Homepage: https://www.skills.sh/imxv/pretty-mermaid-skills/pretty-mermaid
Language: JavaScript
License: MIT
License Family: permissive
Topics: mermaid, skills, agent-skills, ai-agents, ascii-art, claude-code, codex, cursor, diagram-generator, documentation, flowchart, mermaid-diagram, svg
Last push: 2026-08-22T16:40:04+00:00

## Health v2 (maintenance only)
Score: 60/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 99, release rhythm 35, longevity 15
- inputs: {"age_days": 215, "days_push": 11, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1154, forks 58 (observed 2026-08-28T04:03:47.306439+00:00)

## What it is
An AI agent skill with a bundled Node.js CLI that renders Mermaid diagram source into themed SVG, PNG, and terminal ASCII output locally without a browser. It offers 15 themes, six diagram types, and batch parallel rendering, and integrates with agents like Claude Code, Cursor, and Codex.

## Use cases
- render mermaid diagrams as svg without a browser
- convert mermaid source to ascii art for the terminal
- generate themed flowcharts and sequence diagrams for documentation
- export mermaid diagrams as png for sharing
- batch render many mermaid files in parallel
- give my ai coding agent a skill to create diagrams
- render er and class diagrams with custom colors

## When to choose
- you want mermaid rendering without Chromium, Puppeteer, or a DOM
- you need terminal-friendly ASCII/Unicode diagram output
- you use AI coding agents like Claude Code or Cursor and want diagram generation as a skill
- you need consistent themed diagrams across SVG, PNG, and ASCII formats

## When to avoid
- you need mermaid diagram types beyond flowchart, sequence, state, class, ER, or XY charts
- you need interactive or live-rendering diagrams in a web app
- you don't use Node.js (requires Node >= 16)

## Facets
- artifact type: cli-tool
- maturity: active
- function: cli, image-processing, documentation, developer-tools
- domain: developer-tools, documentation, artificial-intelligence
- platform: cli, cross-platform
- tags: mermaid, diagram-rendering, svg, ascii-art, agent-skills, ai-agents, themes, batch-rendering, no-browser, diagrams, command-line, nodejs

## Member repositories
- imxv/Pretty-mermaid-skills (main) score 60

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:03:47.306439+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T06:33:22.755299+00:00, confidence not recorded.
  - readme: https://github.com/imxv/Pretty-mermaid-skills (fetched 2026-08-28T04:03:47.306439+00:00, sha 793f3a371fff)
  - homepage: https://www.skills.sh/imxv/pretty-mermaid-skills/pretty-mermaid (fetched 2026-08-29T12:38:10.538756+00:00, sha d2a305b59653)
  - site_page: https://www.skills.sh/docs (fetched 2026-08-29T12:38:10.547898+00:00, sha 31de1ab39323)
  - site_page: https://www.skills.sh/docs/cli (fetched 2026-08-29T12:38:10.550943+00:00, sha 9a31957cdc16)
  - site_page: https://www.skills.sh/docs/customize (fetched 2026-08-29T12:38:10.553135+00:00, sha 18b425b78010)
  - site_page: https://www.skills.sh/docs/api (fetched 2026-08-29T12:38:10.555063+00:00, sha beb413506f8e)
  - site_page: https://www.skills.sh/docs/faq (fetched 2026-08-29T12:38:10.557066+00:00, sha a21fcc5038e4)
  - site_page: https://www.skills.sh/about (fetched 2026-08-29T12:38:10.558620+00:00, sha 129b9e1b4d9d)
- Data as of 2026-08-30T08:39:29.467469+00:00.