Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add zc277584121/marketing-skills --skill mermaid-to-gif -a claude-code
Open on GitHub

What 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 .md and 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.mmd to GIF with pulse-flow style and dark theme
  • Extract all Mermaid blocks from README.md and generate GIFs in images/
  • Make a GIF from flow.mmd with 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-code

2Manually: put the files in place

~/.claude/skills/mermaid-to-gif/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/mermaid-to-gif/

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).

Similar skills

All skills for Writing and docs →
anime-reaction-gif LIghtJUNction anime-reaction-gif — a plugin for Claude Code and Codex that builds looping reaction GIFs and MP4s from generated pose sheets. It drives image_gen for key poses, then hands the frames to FFmpeg for timing and export. CX Codex ★ 1,596repo stars agent-mermaid-diagram-specialist softaworks agent-mermaid-diagram-specialist — a plugin that generates Mermaid diagrams: flowcharts, sequence diagrams, ERDs, and architecture visualizations. Saves time when you need to sketch out processes, data relationships, or system interactions. ★ 2,707repo stars video-to-gif microsoft video-to-gif converts video clips into optimized animated GIFs using two-pass FFmpeg palette generation. Useful for crafting UI demos and docs previews directly inside the CLI. CX Codex +1 ★ 1,627repo stars gif-sticker-maker MiniMax-AI gif-sticker-maker — a skill for Claude Code and Cursor: turns photos into four animated GIF stickers in Funko Pop / Pop Mart blind box style. Activates on requests for sticker packs, GIF emoji, or animated avatars. CX Codex +1 2,100installs mermaid-visualizer axtonliu mermaid-visualizer transforms text into professional Mermaid diagrams. Visualize processes, system architectures, comparisons and hierarchies with built-in syntax error prevention. CX Codex +1 1,700installs mermaid-diagram-generator patricio0312rev mermaid-diagram-generator is a Claude Code skill that generates Mermaid diagrams in markdown and activates on requests for a Mermaid diagram, flowchart, or architecture diagram. CX Codex +1 348installs

From the same set13

The whole set →
image-generation The image-generation skill creates illustrations, diagrams, and other visuals for articles and docs. It chooses between Codex, OpenAI API, and Gemini paths. CX Codex +1 4,000installs mermaid-to-image mermaid-to-image converts Mermaid diagrams in Markdown files to PNG via the mermaid.ink API and replaces code blocks with image references. CX Codex +1 4,000installs chrome-automation chrome-automation controls an active Chrome window via the agent-browser CLI. Useful for extracting web data, filling forms, and replaying DevTools recordings while keeping active login sessions intact. CX Codex +1 4,000installs content-rewrite content-rewrite turns one article or announcement into versions for LinkedIn, X, Reddit, an English blog and WeChat. Useful when the same material has to go out in several places. CX Codex +1 4,000installs jupyter-notebook-writing jupyter-notebook-writing — a skill for editing Jupyter notebooks in Markdown instead of JSON. Runs on Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode; edit .md files first, then convert to .ipynb using jupyter-switch. CX Codex +1 3,900installs video-to-gif video-to-gif turns one video into several GIFs at different settings and drops them in a folder, so you pick the one that looks right. CX Codex +1 3,900installs raw-video-processing raw-video-processing cleans up raw screen recordings by cutting silent pauses and speeding up the footage. Useful before publishing demos or tutorials. CX Codex +1 3,900installs github-traffic github-traffic pulls traffic metrics, visitor referrers, and clone counts from GitHub. Stores snapshots locally and generates trend charts. CX Codex +1 3,800installs

Project sponsors

Companies that keep this analytics open