Takes markdown files with embedded Mermaid diagrams and spits out numbered PNG images. The bundled script extracts all the diagram blocks, generates high-res PNGs (default 1200x800 at 2x scale), and has smart sizing that adjusts dimensions based on diagram type,timelines get wide and short, architecture diagrams get more pixels. You can crank up the scale factor for presentation or print quality. Built for WSL2 with Chrome/Puppeteer, though you'll need mermaid-cli and Python installed. Worth noting it bundles everything in a scripts directory and requires you to cd there first, which is a little clunky but makes the dependencies portable. Good if you're documenting systems and need actual images instead of hoping your viewer renders Mermaid correctly.

skills.sh installs
1.5K
GitHub stars
1.5K
last updated
Aug 21, 2026

Install

$ npx -y skills add daymade/claude-code-skills --skill mermaid-tools --agent claude-code

Installs into .claude/skills of the current project.

Files

Mermaid Tools

Overview

This skill enables extraction of Mermaid diagrams from markdown files and generation of high-quality PNG images. The skill bundles all necessary scripts (extract-and-generate.sh, extract_diagrams.py, and puppeteer-config.json) in the scripts/ directory for portability and reliability.

Core Workflow

Standard Diagram Extraction and Generation

Extract Mermaid diagrams from a markdown file and generate PNG images using the bundled extract-and-generate.sh script:

cd "${CLAUDE_SKILL_DIR}/scripts"
./extract-and-generate.sh "<markdown_file>" "<output_directory>"

Parameters:

  • <markdown_file>: Path to the markdown file containing Mermaid diagrams
  • <output_directory>: (Optional) Directory for output files. Defaults to <markdown_file_directory>/diagrams

Example:

cd "${CLAUDE_SKILL_DIR}/scripts"
./extract-and-generate.sh "<markdown_file>" "<output_directory>"

What the Script Does

Sponsors

Details

Repository
github.com/daymade/claude-code-skills
Category
Code Review & Quality
First seen
Jun 3, 2026

More from daymade/claude-code-skills

All 53
1pproenca avatarexpo-react-native-performancepproenca/dot-skillsExpo React Native performance optimization guidelines. This skill should be used when writing, reviewing, or refactoring Expo React Native code to ensure optima1.5Kskills.sh installs
2posit-dev avatarquarto-authoringposit-dev/skillsUse when the user is explicitly working with Quarto, .qmd files, _quarto.yml, Quarto projects, or Quarto features such as callouts, cross-references, citations,1.5Kskills.sh installs
3callicrate avataragents-mdcallicrate/skillsUse when the requested deliverable includes creating, reviewing, moving, splitting, or updating a repository AGENTS.md; produces scoped repo guidance. Do not tr1.4Kskills.sh installs
4alirezarezvani avatarsenior-fullstackalirezarezvani/claude-skillsFullstack development toolkit with project scaffolding for Next.js, FastAPI, MERN, and Django stacks, code quality analysis with security and complexity scoring1.4Kskills.sh installs
5anthropics avatarcustomer-pulseanthropics/knowledge-work-pluginsAggregates PayPal disputes, HubSpot feedback and tickets, and email sentiment (plus pasted or exported Google/Yelp reviews) into a themes report with verbatim e1.3Kskills.sh installs
6github avatargeofeed-tunergithub/awesome-copilotUse this skill whenever the user mentions IP geolocation feeds, RFC 8805, geofeeds, or wants help creating, tuning, validating, or publishing a self-published I1.3Kskills.sh installs