Visual Flow Gif
Turns process notes into a PNG and animated GIF flow diagram via a Python/Pillow script
Test report
- Verdict
- Tested · Works
- Score
- Tested
- Jul 21, 2026
- Environment
- Claude Code 2.x (agent harness)
- Upstream re-checked
- Aug 10, 2026 · 8ea4575
Cloned the repo and ran scripts/render_animated_gif.py under Python 3.13 / Pillow 12. Rendering the bundled default-spec.json produced a 253KB PNG and 6.8MB GIF, 48 frames, with --check passing all validations (existence, dimensions, frame count, sampled motion). For the output test I authored a CI-pipeline spec (push->build->test->deploy with a test-fail loop): the skill emitted a 900x420 PNG plus a 1.5MB 48-frame animated GIF with a pulse on the Test node and color roles (blue/green/purple) per the style guide; I visually confirmed the PNG shows readable hand-drawn-style labels and the rounded routed fail loop. Baseline was a static 989-byte SVG with zero animation. My first spec used "arrows" and produced no edges until I corrected it to the documented "edges" field. SKILL.md paths use ${CLAUDE_PLUGIN_ROOT}, which is unset on a plain ~/.claude/skills install, so the run path must be substituted manually.
Scored on four weighted criteria — install, triggering, output vs. baseline, docs. How scoring works
- Installs cleanly 5/5
- Triggers reliably 5/5
- Output vs. baseline 8/10
- Docs & honesty 4/5
What Visual Flow Gif does
Converts source material like articles, workflow notes, or architecture sketches into a flow diagram by authoring a JSON spec and rendering it to a static PNG plus an animated GIF with a bundled Python/Pillow script. Triggers when the user wants to visualize a process, system, or pipeline as an animated diagram rather than a static image or data chart. Includes a color-role style guide, default light/dark specs, and --verify/--check validation of frame count and motion.
How to install Visual Flow Gif
git clone --depth 1 https://github.com/AI-Builder-Club/skills.git /tmp/visual-flow-gif-src
mkdir -p ~/.claude/skills
cp -R /tmp/visual-flow-gif-src/skills/visual-flow-gif ~/.claude/skills/visual-flow-gif
# Requires Python 3.10+ and Pillow 10+ (tested with 3.13 / Pillow 12).
# python3 -m pip install -r ~/.claude/skills/visual-flow-gif/requirements.txt
# Run the renderer directly (SKILL.md references ${CLAUDE_PLUGIN_ROOT}; for a
# standalone skill install substitute ~/.claude/skills/visual-flow-gif):
# python3 ~/.claude/skills/visual-flow-gif/scripts/render_animated_gif.py \
# --spec /path/to/spec.json --outdir /path/to/out --basename diagram --verify --check
# Start from assets/default-spec.json (light) or assets/dark-spec.json; edges use
# the "edges" field, not "arrows". Excalifont is optional; renderer falls back.
Skills live in ~/.claude/skills/ (global) or .claude/skills/
(per-project). Restart Claude Code after installing.
Commands — how to trigger Visual Flow Gif
-
/visual-flow-gifTurns process notes into a PNG and animated GIF flow diagram via a Python/Pillow script
It also activates on plain-language prompts like these:
-
Turn this architecture sketch into an animated GIF -
Create a flow diagram from these workflow notes -
Generate a PNG diagram from this article
Frequently asked questions
- Is the Visual Flow Gif skill free?
- Yes. The skill itself is free from AI-Builder-Club/skills. SkillProof publishes the install command and an independent test verdict at no cost.
- Does Visual Flow Gif work with Claude Code?
- We tested it with Claude Code 2.x (agent harness) on Jul 21, 2026. Verdict: Tested · Works. Cloned the repo and ran scripts/render_animated_gif.py under Python 3.13 / Pillow 12. Rendering the bundled default-spec.json produced a 253KB PNG and 6.8MB GIF, 48 frames, with --check passing all validations (existence, dimensions, frame count, sampled motion). For the output test I authored a CI-pipeline spec (push->build->test->deploy with a test-fail loop): the skill emitted a 900x420 PNG plus a 1.5MB 48-frame animated GIF with a pulse on the Test node and color roles (blue/green/purple) per the style guide; I visually confirmed the PNG shows readable hand-drawn-style labels and the rounded routed fail loop. Baseline was a static 989-byte SVG with zero animation. My first spec used "arrows" and produced no edges until I corrected it to the documented "edges" field. SKILL.md paths use ${CLAUDE_PLUGIN_ROOT}, which is unset on a plain ~/.claude/skills install, so the run path must be substituted manually.
- What is the Visual Flow Gif SkillProof Score?
- 8.8/10 — installs cleanly 5/5, triggers reliably 5/5, output vs. baseline 8/10, docs & honesty 4/5.
- How do I install Visual Flow Gif?
- Copy the install command from this page, run it in your terminal, and restart Claude Code. Skills live in ~/.claude/skills/ (global) or .claude/skills/ inside a project.
- Can I use Visual Flow Gif with Cursor, Copilot, Gemini CLI, Codex or other AI tools?
- The SKILL.md format is native to Claude (Claude Code, Desktop, claude.ai). The instructions inside adapt to other assistants: Cursor rules, GitHub Copilot instructions, Windsurf rules, Custom GPTs, AGENTS.md for OpenAI Codex, and GEMINI.md for Google Gemini CLI — our conversion guides cover each, and the free converter on the tools page does the wrapping for you.