How do I install the Beautiful Mermaid Ascii skill?

Run npx skillmds@latest add levalencia/beautiful-mermaid-ascii in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Beautiful Mermaid Ascii safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: executes scripts. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Beautiful Mermaid Ascii?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Beautiful Mermaid Ascii free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Beautiful Mermaid Ascii?

levalencia (@levalencia) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Beautiful Mermaid Ascii by levalencia

Name: Beautiful Mermaid Ascii
Rating: 4.2 (5 reviews)
Author: levalencia

Beautiful Mermaid Ascii

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.

levalencia Updated Sep 8, 2026 3 repo stars

File contents

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

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.

---name: beautiful-mermaid-asciidescription: 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.---# Beautiful Mermaid ASCII RenderingUse `lukilabs/beautiful-mermaid` (a JS library, not a CLI) to turn Mermaid diagrams into terminal-friendly ASCII/Unicode art.## Quick startRender a Mermaid file:```bashskills/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):```bashskills/beautiful-mermaid-ascii/scripts/install-mermaid-ascii```Render from stdin:```bashcat path/to/diagram.mmd | skills/beautiful-mermaid-ascii/scripts/mermaid-ascii```Render the first Mermaid fenced block from Markdown:```bashskills/beautiful-mermaid-ascii/scripts/mermaid-ascii --md README.md```Select a different fenced block (1-based):```bashskills/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:```bashskills/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 rootNPM_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:```bashskills/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.

Frequently asked questions