ratacat/beautiful-mermaid-ascii
skills/beautiful-mermaid-ascii/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.
$ install --global
skillsauthnpx skillsauth add ratacat/claude-skills beautiful-mermaid-asciiInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 11, 2026, 8:36 PM4.5s8 files scanned
SKILL.md
- name:
- beautiful-mermaid-ascii
- description:
- 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 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
~/.npmor~/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
--listto 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 callsrenderMermaidAscii.skills/beautiful-mermaid-ascii/references/notes.md: Small notes about Mermaid inputs and common patterns.
Related Skills
ratacat/xcode-test
tools
VerifiedTrustedCommunity
Build and test iOS apps on simulator using XcodeBuildMCP
29SKILL.mdUpdated Apr 11, 2026
ratacat/writing-documentation
development
VerifiedTrustedCommunity
Produces concise, clear documentation by applying Elements of Style principles. Use when writing or improving any technical documentation (READMEs, guides, API docs, architecture docs). Not for code comments.
29SKILL.mdUpdated Apr 11, 2026
ratacat/writing-skills
testing
VerifiedTrustedCommunity
Use when user asks to create, write, edit, or test a skill. Also use when documenting reusable techniques, patterns, or workflows for future Claude instances.
29SKILL.mdUpdated Apr 11, 2026
ratacat/workflows-work
testing
VerifiedTrustedCommunity
Execute work plans efficiently while maintaining quality and finishing features
29SKILL.mdUpdated Apr 11, 2026