SkillsAdd

ratacat/claude-skills

beautiful-mermaid-ascii

Render Mermaid diagrams as readable ASCII/Unicode art in the terminal (from .mmd/.mermaid files, stdin, or Markdown ```mermaid fences).

First seen Feb 1, 2026

Installation

$ npx skills add ratacat/claude-skills --skill beautiful-mermaid-ascii
View on skills.sh ↗ GitHub repository ↗

Summary

  • Render Mermaid diagrams as readable ASCII/Unicode art in the terminal (from .mmd/.mermaid files, stdin, or Markdown ```mermaid fences).
  • Use when installing or using lukilabs/beautiful-mermaid, creating a CLI renderer for Mermaid-to-ASCII output, previewing Mermaid diagrams in terminal, or extracting/rendering Mermaid blocks from Markdown files.

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

beautiful-article Similar name
conardli/garden-skills

把用户提供的素材（网页 URL / PDF / DOCX / Markdown / 纯文本 / 截图 / 粘贴材料）编辑、设计成一篇…

2.5K installs
designing-beautiful-websites Similar name
tristanmanchester/agent-skills

>- Designs UX/UI for websites and web apps: UX strategy, information architecture, user flows, …

2.6K installs
beautiful-mermaid Similar name
intellectronica/agent-skills

Render Mermaid diagrams as SVG and PNG using the Beautiful Mermaid library. Use when the user a…

1.8K installs
beautiful-shadows Similar name
mengto/skills

Apply exact Tailwind arbitrary shadow utilities for polished, layered neutral elevation. Use wh…

17 installs
beautifulsoup-parsing Similar name
mindrally/skills

Expert guidance for HTML/XML parsing using BeautifulSoup in Python with best practices for DOM …

817 installs
beautiful-mermaid Similar name
calesthio/openmontage

Render Mermaid diagrams as SVG and PNG using the Beautiful Mermaid library. Use when the user a…

7 installs

Also in this package

Other skills from ratacat/claude-skills · top by installs.

npx skills add ratacat/claude-skills
ripgrep 398 clean-code 355 annas-archive-ebooks 292 brave-search 279 design-patterns 119 web-interface-design 114 ebook-extractor 107 postgres-query-expert 63 data-systems-architecture 62 documentation-scraper 62

Browse all from ratacat/claude-skills

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 53
License MIT
Default branch main
Open issues 3
Status Active

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 2,997 B
  • docs SUMMARY.md 377 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 47 installs

SKILL.md

Beautiful Mermaid ASCII Rendering

Use lukilabs/beautiful-mermaid (a JS library, not a CLI) to turn Mermaid diagrams into terminal-friendly ASCII/Unicode art.

Quick start

Render a Mermaid file:

skills/beautiful-mermaid-ascii/scripts/mermaid-ascii path/to/diagram.mmd

Install a clean mermaid-ascii command on your PATH (symlink into ~/.local/bin by default):

skills/beautiful-mermaid-ascii/scripts/install-mermaid-ascii

Render from stdin:

cat path/to/diagram.mmd | skills/beautiful-mermaid-ascii/scripts/mermaid-ascii

Render the first Mermaid fenced block from Markdown:

skills/beautiful-mermaid-ascii/scripts/mermaid-ascii --md README.md

Select a different fenced block (1-based):

skills/beautiful-mermaid-ascii/scripts/mermaid-ascii --md README.md --block 2

Installation approach (how this skill “deals with installing”)

scripts/mermaid-ascii auto-installs beautiful-mermaid into a writable cache directory (defaults to $XDGCACHEHOME/beautiful-mermaid-ascii, or /tmp/beautiful-mermaid-ascii) when needed, then runs the renderer.

If you want a “real” command on your PATH, prefer the symlink installer:

skills/beautiful-mermaid-ascii/scripts/install-mermaid-ascii

You can also install this folder as a local/global npm package (use a writable npm cache if your ~/.npm is not writable):

# from the repo root
NPM_CONFIG_CACHE=/tmp/npm-cache npm install -g --prefix ~/.local ./skills/beautiful-mermaid-ascii

If you already have beautiful-mermaid installed in the current project, run with:

skills/beautiful-mermaid-ascii/scripts/mermaid-ascii --pkg-dir . path/to/diagram.mmd

Troubleshooting

  • If installs fail due to permission errors in ~/.npm or ~/Library/Caches, run with a writable cache directory:

- skills/beautiful-mermaid-ascii/scripts/mermaid-ascii --cache-dir /tmp/bm-cache ...

  • If output is empty, verify the Mermaid text is valid and starts with a diagram type (flowchart, sequenceDiagram, etc.).
  • For multiple diagrams in Markdown, use --list to enumerate fenced blocks and choose one with --block.

Bundled resources

  • skills/beautiful-mermaid-ascii/scripts/mermaid-ascii: Shell wrapper that ensures dependencies are available, then renders.
  • skills/beautiful-mermaid-ascii/scripts/mermaid-ascii.mjs: Node CLI that extracts Mermaid (raw or from Markdown fences) and calls renderMermaidAscii.
  • skills/beautiful-mermaid-ascii/references/notes.md: Small notes about Mermaid inputs and common patterns.