Agent skill
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.
Install this agent skill to your Project
npx add-skill https://github.com/ratacat/claude-skills/tree/main/skills/beautiful-mermaid-ascii
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 $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.
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
ratacat/claude-skills
brave-search
Use when user asks to search the web, look something up online, find current/recent/latest information, or needs cited answers. Triggers on "search", "look up", "find out about", "what is the current/latest", image searches, news lookups. NOT for searching code/files—only for web/internet searches.
ratacat/claude-skills
bug-reproduction-validator
Use this agent when you receive a bug report or issue description and need to verify whether the reported behavior is actually a bug. This agent will attempt to reproduce the issue systematically, validate the steps to reproduce, and confirm whether the behavior deviates from expected functionality. <example>\nContext: The user has reported a potential bug in the application.\nuser: "Users are reporting that the email processing fails when there are special characters in the subject line"\nassistant: "I'll use the bug-reproduction-validator agent to verify if this is an actual bug by attempting to reproduce it"\n<commentary>\nSince there's a bug report about email processing with special characters, use the bug-reproduction-validator agent to systematically reproduce and validate the issue.\n</commentary>\n</example>\n<example>\nContext: An issue has been raised about unexpected behavior.\nuser: "There's a report that the brief summary isn't including all emails from today"\nassistant: "Let me launch the b...
ratacat/claude-skills
agent-native-audit
Run comprehensive agent-native architecture review with scored principles
ratacat/claude-skills
brainstorming
This skill should be used before implementing features, building components, or making changes. It guides exploring user intent, approaches, and design decisions before planning. Triggers on "let's brainstorm", "help me think through", "what should we build", "explore approaches", ambiguous feature requests, or when the user's request has multiple valid interpretations that need clarification.
ratacat/claude-skills
performance-oracle
Use this agent when you need to analyze code for performance issues, optimize algorithms, identify bottlenecks, or ensure scalability. This includes reviewing database queries, memory usage, caching strategies, and overall system performance. The agent should be invoked after implementing features or when performance concerns arise.\n\n<example>\nContext: The user has just implemented a new feature that processes user data.\nuser: "I've implemented the user analytics feature. Can you check if it will scale?"\nassistant: "I'll use the performance-oracle agent to analyze the scalability and performance characteristics of your implementation."\n<commentary>\nSince the user is concerned about scalability, use the Task tool to launch the performance-oracle agent to analyze the code for performance issues.\n</commentary>\n</example>\n\n<example>\nContext: The user is experiencing slow API responses.\nuser: "The API endpoint for fetching reports is taking over 2 seconds to respond"\nassistant: "Let me invoke the...
ratacat/claude-skills
triage
Triage and categorize findings for the CLI todo system
Didn't find tool you were looking for?