Agent skill

mermaid

Must read guide on creating/editing mermaid charts with valiation tools

View SKILL.md on GitHub Repository
Stars 1,802
Forks 123

Install this agent skill to your Project

npx add-skill https://github.com/mitsuhiko/agent-stuff/tree/main/skills/mermaid

SKILL.md

Mermaid Skill

Use this skill to quickly validate Mermaid diagrams by parsing + rendering them with the official Mermaid CLI.

Prerequisites

  • Node.js + npm (for npx).
  • First run downloads a headless Chromium via Puppeteer. If Chromium is missing, set PUPPETEER_EXECUTABLE_PATH.

Tool

Validate a diagram

bash
./tools/validate.sh diagram.mmd [output.svg]
  • Parses and renders the Mermaid source.
  • Non-zero exit = invalid Mermaid syntax.
  • Prints an ASCII preview using beautiful-mermaid (best-effort; not all diagram types are supported).
  • If output.svg is omitted, the SVG is rendered to a temp file and discarded.

Workflow (short)

  1. If the diagram will live in Markdown: draft it in a standalone diagram.mmd first (the tool only validates plain Mermaid files).
  2. Write/update diagram.mmd.
  3. Run ./tools/validate.sh diagram.mmd.
  4. Fix any errors shown by the CLI.
  5. Once it validates, copy the Mermaid block into your Markdown file.

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

mitsuhiko/agent-stuff

update-changelog

Read this skill before updating changelogs

1,802 123
Explore
mitsuhiko/agent-stuff

web-browser

Allows to interact with web pages by performing actions such as clicking buttons, filling out forms, and navigating links. It works by remote controlling Google Chrome or Chromium browsers using the Chrome DevTools Protocol (CDP). When Claude needs to browse the web, it can use this skill to do so.

1,802 123
Explore
mitsuhiko/agent-stuff

summarize

Fetch a URL or convert a local file (PDF/DOCX/HTML/etc.) into Markdown using `uvx markitdown`, optionally it can summarize

1,802 123
Explore
mitsuhiko/agent-stuff

commit

Read this skill before making git commits

1,802 123
Explore
mitsuhiko/agent-stuff

anachb

Austrian public transport (VOR AnachB) for all of Austria. Query real-time departures, search stations/stops, plan routes between locations, and check service disruptions. Use when asking about Austrian trains, buses, trams, metro (U-Bahn), or directions involving public transport in Austria.

1,802 123
Explore
mitsuhiko/agent-stuff

tmux

Remote control tmux sessions for interactive CLIs (python, gdb, etc.) by sending keystrokes and scraping pane output.

1,802 123
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results