mermaid-to-gif — Claude Code skill: what it does, how to install
mermaid-to-gif turns Mermaid diagrams from .mmd and .md files into animated GIFs with four animation styles.
no license 3,900 installs updated 2026-08-28
npx skills add zc277584121/marketing-skills --skill mermaid-to-gif -a claude-codeWhat mermaid-to-gif does
The skill runs a Python script that renders Mermaid blocks through Playwright and assembles frames into GIFs via FFmpeg. Four animation styles: progressive lights up nodes and edges in sequence, highlight-walk moves a spotlight with blue glow through the diagram, pulse-flow runs a dashed pattern along edges, wave sends a brightness ripple through elements. All elements are visible from frame one — animation adds motion to the complete structure.
The script will not start without FFmpeg in PATH, Python 3.8+, and Playwright (pip install playwright && playwright install chromium). The skill can extract all blocks from a single .md file and generate one GIF per block. You can set theme (--theme dark), background, FPS, and animation duration. For each diagram, the style is chosen by meaning: pulse-flow for data flow, progressive for layered architecture, wave for reference diagrams.
What it helps with
- turn Mermaid diagrams into GIFs for documentation
- animate data flow or system architecture
- extract all diagrams from
.mdand generate a set of GIFs - add animation to a step-by-step process
- build visuals for a presentation from Mermaid blocks
Example prompts for the agent
- Convert
diagram.mmdto GIF withpulse-flowstyle and dark theme - Extract all Mermaid blocks from
README.mdand generate GIFs inimages/ - Make a GIF from
flow.mmdwith 15 FPS and 5 seconds duration
How to install mermaid-to-gif
1Skills CLI (Vercel)
npx skills add zc277584121/marketing-skills --skill mermaid-to-gif -a claude-code2Manually: put the files in place
~/.claude/skills/mermaid-to-gif/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/mermaid-to-gif/
1Skills CLI (Vercel)
npx skills add zc277584121/marketing-skills --skill mermaid-to-gif -a codex2Manually: put the files in place
.agents/skills/mermaid-to-gif/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add zc277584121/marketing-skills --skill mermaid-to-gif -a cursor2Manually: put the files in place
.cursor/skills/mermaid-to-gif/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install zc277584121/marketing-skills skills/mermaid-to-gif2Manually: put the files in place
.github/skills/mermaid-to-gif/SKILL.md1Skills CLI (Vercel)
npx skills add zc277584121/marketing-skills --skill mermaid-to-gif -a gemini-cli2Platform CLI
gemini skills install https://github.com/zc277584121/marketing-skills --path skills/mermaid-to-gifManually: put the files in place
.devin/skills/mermaid-to-gif/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add zc277584121/marketing-skills --skill mermaid-to-gif -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about mermaid-to-gif
How to install mermaid-to-gif in Claude Code?
Run npx skills add zc277584121/marketing-skills --skill mermaid-to-gif -a claude-code, then open ~/.claude/skills/mermaid-to-gif/SKILL.md.
What does mermaid-to-gif do?
Turns Mermaid diagrams into animated GIFs with a choice of animation style: sequential node lighting, spotlight walk, flowing dashes along edges, or brightness wave.
What does mermaid-to-gif require to work?
FFmpeg in PATH, Python 3.8+, and installed Playwright (pip install playwright && playwright install chromium).