paldom/storytelling-animation

animation-frame-qa

Reviews a rendered animation video at delivery size before sign-off - bounded contact sheet, phone-width stills, safe-area overlay, loop seam strip, luminance flash report, a look-at-it checklist with pass, fail or manual verdicts.

Vedi sorgente

Come usare

  1. Copia il comando e controlla il pacchetto prima di installarlo nel tuo ambiente agente.
  2. Controlla strumenti, credenziali e ambienti richiesti nel documento originale.
  3. Descrivi input e risultato desiderato; confronta l’output con le fonti.
npx skills add https://github.com/paldom/storytelling-animation --skill animation-frame-qa

Prima di iniziare

  • L’installazione non include abbonamenti, quote API o accesso ai file.
  • Stelle e installazioni indicano attività, non un test indipendente di qualità o sicurezza.
Documento Skill originale

Contenuto dal repository con titoli, esempi, codice, tabelle, link e immagini preservati.

animation-frame-qa

Makes an agent look at the video it made, the way a viewer will see it, before it says "done". It fixes the failure where a render that passed every script check still ships with an unreadable phone view, a CTA under the feed controls, a hook frame that is blank, a seam that jumps, or a flash nobody noticed because nobody opened a frame.

When to use / when NOT to use

Use on a finished MP4 or GIF when someone asks to review, check, QA, proof or sign it off, when a client says text looks tiny, or when something flickers or strobes and the frames need finding.

Do NOT use for: producing the files (animation-export-presets), fixing motion (smooth-motion-choreography), fixing layout (vector-scene-layout), checking colour pairs before layout (that skill's contrast command), code review, web accessibility audits, extracting frames for other purposes, or film criticism.

Workflow

  1. Produce the artefacts into a fresh folder per deliverable (bounded: ≤ 60

sampled frames, tiles scaled first, exact decoded frame count):

bash
   python3 "${CLAUDE_SKILL_DIR}/scripts/qa_frames.py" out/linkedin-4x5.mp4 --out out/qa-linkedin-4x5 --family feed --storyboard storyboard.json
   python3 "${CLAUDE_SKILL_DIR}/scripts/qa_frames.py" out/gif-loop.gif --out out/qa-gif-loop --family feed --storyboard storyboard.json --wrap

--family is feed (LinkedIn 4:5, 1:1, 16:9, GIF), vertical (9:16) or slide (PowerPoint); --storyboard adds a settled phone-width still per beat; --wrap adds the loop seam strip. A non-zero exit means an artefact could not be made.

  1. Open every image the script wrote: contact.png, phone-first/mid/last.png,

phone-beat-<id>.png, safe-first/mid/last.png, wrap.png. Read report.json for the luminance jumps.

  1. Walk the checklist in references/review-checklist.md: poster frame, phone

legibility, safe areas, pacing and stillness, luminance jumps, loop seam, delivery facts, credits. Decide each item pass or fail with the frame numbers or beat ids.

  1. Record the decisions into the report so the pipeline can tell reviewed from

generated:

bash
   python3 "${CLAUDE_SKILL_DIR}/scripts/qa_frames.py" --record out/qa-linkedin-4x5/report.json "poster frame reads alone=pass" "CTA still=pass"
  1. Route each failure to the skill that owns it (table in the checklist) and

re-run this review after the fix. Do not re-encode to fix a motion or layout defect.

  1. Close only when every item is recorded pass. This is local visual QA; say so,

and list what stays manual outside the repo (platform preview, presenter machine).

Output spec

  • out/qa-<preset>/ per deliverable with the images and report.json whose checks

are all recorded pass.

  • A verdict per checklist item with evidence (frame numbers, which image), the

routed fixes, and an explicit "not done" when anything failed or was unverified.

Gotchas

  • The contact sheet samples at most 60 frames: it shows pacing, not every frame.

The luminance report covers every decoded frame but only mean luma; it finds cuts and broken frames, not flash safety, which stays a judgement call.

  • Every luminance jump not at a storyboard transition is a defect (unloaded font,

missing asset, random value).

  • Old images in a reused folder are not evidence; the script refuses a non-empty

--out.

  • Judge legibility on the 390 px stills, never on the full-size frames; the full-size

frames always look fine.

  • Frame 0 is the thumbnail on LinkedIn; a fade-from-black hook means a black thumbnail.
  • For loops, "last frame equals first frame" is wrong; the last frame is one step

before the first. Judge the seam on the wrap strip's continuity, not on equality.

  • check_output.py (export skill) proves the container; this skill proves the

picture. Neither proves the platform accepted the upload: do a test post.

  • Safe areas are heuristics from EBU R95, Meta Reels and LinkedIn's "keep the edges

free"; a client's own overlay (subtitle band, watermark) may need more.

Pointers

  • scripts/qa_frames.py — artefacts + luminance report; --storyboard, --wrap, --family, --record, --self-test.
  • references/review-checklist.md — the eight checks, sources, and the routing table.
dallo stesso repository

Altri Skills

Tutti gli Skills
paldom
Community

animation-export-presets

Renders a finished Remotion animation to delivery files for every target - LinkedIn feed (4:5, 1:1, 9:16, 16:9), PowerPoint embed, GIF loop, a custom size or 4K at any fps - with sourced H.264 and GIF presets, ffmpeg post-steps, an ffprobe file checker. Use when the user asks to render, export, encode or resize the video for LinkedIn, PowerPoint, GIF, a screen or resolution. Not for animating.

Installazioni / 1h
1
GitHub Stars
0
Aggiornato
1 nov
paldom
Community

smooth-motion-choreography

Choreographs smooth motion for existing Remotion vector scenes - enter, hold, emphasis, camera and exit moves, ease and spring presets (settle, overshoot, no bounce), stagger, draw-on, transitions, loop seams, a flicker linter. Use when the user asks to animate scenes or icons, ease something in, smooth jerky, flickering or popping motion, or fix a loop that jumps. Not for CSS, web UI, or export.

Installazioni / 1h
1
GitHub Stars
0
Aggiornato
1 nov
paldom
Community

vector-asset-sourcing

Picks icon and illustration packs licensed for a commercial rendered video - license and credit matrix, one-pack stroke consistency, SVG and Lottie hygiene checks, pinning, assets manifest. Use when the user asks which pack to use for the animation, whether an SVG, Lottie or illustration may go in the video, or to add assets for its scenes. Not for app or web UI icons, scene layout, or animating.

Installazioni / 1h
1
GitHub Stars
0
Aggiornato
1 nov
paldom
Community

vector-scene-layout

Builds the static vector scenes of an animation as Remotion components - project scaffold, design tokens per target (safe margins, font sizes, stroke, contrast), one scene per beat, stills. Use when the user asks to set up the Remotion project, design or lay out the scenes or frames of an animation, or fix text that is too small or cut off. Not for storyboarding, motion, or rendering video.

Installazioni / 1h
1
GitHub Stars
0
Aggiornato
1 nov