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.

소스 보기

사용 방법

  1. 설치 명령을 복사하고 자신의 에이전트 환경에 설치하기 전에 소스 패키지를 확인하세요.
  2. 필요한 도구, 인증 정보, 지원 환경은 원본 문서에서 확인하세요.
  3. 입력과 원하는 산출물을 설명하고 출처와 결과를 대조하세요.
npx skills add https://github.com/paldom/storytelling-animation --skill animation-frame-qa

시작 전 확인

  • 설치에는 모델 구독, API 한도, 파일 접근 권한이 포함되지 않습니다.
  • 별점 수와 설치 수는 활동 지표이며 독립적인 품질·보안 검증이 아닙니다.
원본 Skill 문서

원본 저장소의 제목, 예시, 코드, 표, 링크, 이미지를 유지해 표시합니다.

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.
같은 저장소의 Skills

더 많은 Skills

모든 Skills
paldom
커뮤니티

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.

1시간 설치 수
1
GitHub Stars
0
업데이트
11월 1일
paldom
커뮤니티

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.

1시간 설치 수
1
GitHub Stars
0
업데이트
11월 1일
paldom
커뮤니티

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.

1시간 설치 수
1
GitHub Stars
0
업데이트
11월 1일
paldom
커뮤니티

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.

1시간 설치 수
1
GitHub Stars
0
업데이트
11월 1일