🎯

beautiful-mermaid-ascii

🎯Skill

from ratacat/claude-skills

What it does

Renders Mermaid diagrams as readable ASCII/Unicode art in the terminal from files, stdin, or Markdown fenced blocks.

📦

Part of

ratacat/claude-skills(26 items)

beautiful-mermaid-ascii

Installation

PythonRun Python server

python3 annas.py search "Clean Code Robert Martin" --format pdf

PythonRun Python server

python3 annas.py download <md5> --output ./books/

Shell ScriptRun shell script

./setup.sh

PythonRun Python server

python3 scripts/extract.py input.epub output.txt

PythonRun Python server

python3 scripts/extract.py input.pdf output.txt

+ 2 more commands

📖 Extracted from docs: ratacat/claude-skills

Need more details? View full documentation on GitHub →

3Installs

AddedFeb 4, 2026

View on GitHub Back to Skills

Skill Details

SKILL.md

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.

Overview

# 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:

```bash

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):

```bash

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

```

Render from stdin:

```bash

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

```

Render the first Mermaid fenced block from Markdown:

```bash

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

```

Select a different fenced block (1-based):

```bash

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 $XDG_CACHE_HOME/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:

```bash

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):

```bash

# 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:

```bash

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.

More from this repository10

🎯

ripgrep🎯Skill

ripgrep skill from ratacat/claude-skills

🎯

web-interface-design🎯Skill

web-interface-design skill from ratacat/claude-skills

🎯

documentation-scraper🎯Skill

documentation-scraper skill from ratacat/claude-skills

🎯

postgres-query-expert🎯Skill

postgres-query-expert skill from ratacat/claude-skills

🎯

claude-md-authoring🎯Skill

claude-md-authoring skill from ratacat/claude-skills

🎯

project-setup🎯Skill

project-setup skill from ratacat/claude-skills

🎯

writing-documentation🎯Skill

writing-documentation skill from ratacat/claude-skills

🎯

design-patterns🎯Skill

Guides developers in applying proven architectural solutions by recommending design patterns that solve specific software structural and behavioral challenges.

🎯

brainstorming🎯Skill

Helps users explore and refine project or writing ideas through targeted questions, uncovering insights and challenging assumptions without imposing external perspectives.

🎯

calci-prediction-market🎯Skill

calci-prediction-market skill from ratacat/claude-skills