# mermaid-to-gif

mermaid-to-gif turns Mermaid diagrams from .mmd and .md files into animated GIFs with four animation styles.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 3900 installs
- Author: zc277584121
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/zc277584121/marketing-skills/tree/HEAD/skills/mermaid-to-gif/SKILL.md
- Updated: 2026-08-28
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/mermaid-to-gif

## What it 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.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add zc277584121/marketing-skills --skill mermaid-to-gif -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/mermaid-to-gif/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/mermaid-to-gif/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add zc277584121/marketing-skills --skill mermaid-to-gif -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/mermaid-to-gif/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add zc277584121/marketing-skills --skill mermaid-to-gif -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/mermaid-to-gif/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install zc277584121/marketing-skills skills/mermaid-to-gif
```

2. **Manually: put the files in place**
- File: `.github/skills/mermaid-to-gif/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add zc277584121/marketing-skills --skill mermaid-to-gif -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/zc277584121/marketing-skills --path skills/mermaid-to-gif
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/mermaid-to-gif/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add zc277584121/marketing-skills --skill mermaid-to-gif -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/zc277584121/marketing-skills/tree/HEAD/skills/mermaid-to-gif/SKILL.md

## When to use it
- 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
- 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

## Similar
- [anime-reaction-gif](https://affpapa.org/en/nevibecode/plugins/anime-reaction-gif.md) — plugin · ★ 1596 repo stars
- [agent-mermaid-diagram-specialist](https://affpapa.org/en/nevibecode/plugins/agent-mermaid-diagram-specialist.md) — plugin · ★ 2707 repo stars
- [video-to-gif](https://affpapa.org/en/nevibecode/skills/microsoft-video-to-gif.md) — skill · ★ 1627 repo stars
- [gif-sticker-maker](https://affpapa.org/en/nevibecode/skills/minimax-ai-gif-sticker-maker.md) — skill · 2100 installs
- [mermaid-visualizer](https://affpapa.org/en/nevibecode/skills/mermaid-visualizer.md) — skill · 1700 installs
- [mermaid-diagram-generator](https://affpapa.org/en/nevibecode/skills/mermaid-diagram-generator.md) — skill · 348 installs

From the same set: [zc277584121/marketing-skills](https://affpapa.org/en/nevibecode/by/zc277584121/marketing-skills.md) — 13 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
