Visual Flow Gif

Trasforma note di processo in un diagramma di flusso PNG e GIF animato tramite uno script Python/Pillow

di AI-Builder-Club · AI-Builder-Club/skills

Promosso ★ 8.8/10

Visual Flow Gif — Trasforma note di processo in un diagramma di flusso PNG e GIF animato tramite uno script Python/Pillow

Cosa fa

Converte materiale sorgente come articoli, note di workflow o schizzi di architettura in un diagramma di flusso, creando una specifica JSON e rendendola in un PNG statico più una GIF animata con uno script Python/Pillow incluso. Si attiva quando l'utente desidera visualizzare un processo, un sistema o una pipeline come diagramma animato piuttosto che come immagine statica o grafico dati. Include una guida di stile per i ruoli colore, specifiche predefinite chiaro/scuro e validazione --verify/--check del conteggio dei frame e del movimento.

Rapporto di test

Clonato il repository e eseguito scripts/render_animated_gif.py con Python 3.13 / Pillow 12. Il rendering del default-spec.json incluso ha prodotto un PNG di 253KB e una GIF di 6.8MB, 48 frame, con --check che ha superato tutte le validazioni (esistenza, dimensioni, conteggio frame, movimento campionato). Per il test di output ho creato una specifica di pipeline CI (push->build->test->deploy con un loop di fallimento del test): la skill ha emesso un PNG 900x420 più una GIF animata di 1.5MB a 48 frame con un impulso sul nodo Test e ruoli colore (blu/verde/viola) secondo la guida di stile; ho confermato visivamente che il PNG mostra etichette leggibili in stile disegnato a mano e il loop di fallimento arrotondato. La baseline era un SVG statico di 989 byte senza animazione. La mia prima specifica usava "arrows" e non produceva bordi finché non l'ho corretta al campo documentato "edges". I percorsi di SKILL.md usano ${CLAUDE_PLUGIN_ROOT}, che non è impostato in un'installazione semplice di ~/.claude/skills, quindi il percorso di esecuzione deve essere sostituito manualmente.

Testato il: 2026-07-21 · Claude Code 2.x (agent harness)

Installazione

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.

Comandi e prompt di esempio

/visual-flow-gifTrasforma note di processo in un diagramma di flusso PNG e GIF animato tramite uno script Python/Pillow

Gli skill si attivano con richieste in linguaggio naturale, senza comandi da ricordare. Dopo l'installazione, prompt come questi lo attivano (in inglese):

Turn this architecture sketch into an animated GIF
Create a flow diagram from these workflow notes
Generate a PNG diagram from this article

Rapporto completo →