
Mermaid Tools
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-codeInstalls 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- Skill Reviewer1.5K
- Statusline Generator1.5K
- Skills Search1.5K
- Capture Screen1.1K
- Pdf Creator1K
- Docs Cleaner1K
- Claude Md Progressive Disclosurer1K
- Claude Code History Files Finder1K
- Github Contributor991
- Video Comparer990
- Llm Icon Finder989
- Cli Demo Generator978
- Cloudflare Troubleshooting978
- Teams Channel Post Writer970
- Claude Skills Troubleshooting960
- Repomix Safe Mixer946
- Financial Data Collector917
- Repomix Unmixer916
- Doc To Markdown914
- Product Analysis909
- Windows Remote Desktop Connection Doctor843
- Scrapling Skill827
- Skill Creator805
- Fixing Claude Export Conversations796