paldom/storytelling-animation

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.

查看源码

使用方法

  1. 复制安装命令,在自己的智能体环境安装前先检查源码包。
  2. 从原始文档核对所需工具、凭据和支持的宿主。
  3. 说明输入材料与期望交付物,并对照来源检查输出。
npx skills add https://github.com/paldom/storytelling-animation --skill animation-export-presets

开始前需了解

  • 安装不包含模型订阅、API 额度或访问文件的权限。
  • 仓库星数和安装量反映活跃情况,不等于独立质量或安全测试。
仓库原始内容

按源仓库内容呈现,保留标题、案例、代码、表格、链接以及原文引用的演示图片。

animation-export-presets

Turns a rendered Remotion composition into files that play where they are going. It fixes the failures that show up after "the render worked": yuv444p or odd-sized MP4s LinkedIn rejects, untagged colour that shifts on some players, moov-at-the-end files that stall, PowerPoint clips that scrub badly or show a seam, GIFs posted to LinkedIn as a static image, and 4K rooms fed a soft 1080p upscale. Every preset carries its source URL and date in assets/presets.json.

When to use / when NOT to use

Use when the animation is done and someone needs the MP4/GIF for a platform, a different size or fps, a fix for a file a platform or PowerPoint refused, or a check that a delivered file matches a preset.

Do NOT use for: animating (smooth-motion-choreography), judging the look of frames (animation-frame-qa), storyboards or layout, compressing screen recordings, deck conversion, uploading or writing the post, or installing ffmpeg.

Workflow

  1. Preconditions: animation.config.json has remotion_license_basis (the

renderer refuses otherwise), every target in it has a composition (Root.tsx), npx remotion compositions src/index.ts lists them, ffmpeg and ffprobe are on PATH.

  1. Pick presets from assets/presets.json: linkedin-4x5 (default feed),

linkedin-1x1, linkedin-9x16, linkedin-16x9, pptx-16x9, pptx-4k, gif-loop, custom (composition custom from the storyboard's custom_size). Why each is what it is: references/delivery-specs.md.

  1. Render from the project root (the script runs Remotion inside --project):
bash
   python3 "${CLAUDE_SKILL_DIR}/scripts/render.py" --project . --preset linkedin-4x5 --preset pptx-16x9

One master per composition (CRF 10, PNG frames, BT.709, with a sidecar recording the storyboard and flags it came from), then one ffmpeg pass per deliverable. Each deliverable is checked before it replaces out/<preset>.mp4|gif; a failed check leaves the previous file untouched. --reuse-masters reuses a master whose sidecar matches; --input file.mp4 re-encodes an existing file (the repair path for "PowerPoint won't play it"); --dry-run prints the commands.

  1. Check any file against its preset (the renderer already did this for what it

published; run it on files from elsewhere or after edits):

bash
   python3 "${CLAUDE_SKILL_DIR}/scripts/check_output.py" out/linkedin-4x5.mp4 --preset linkedin-4x5 --project .

Expected size and fps come from the preset and the project's storyboard.json (custom_size for the custom preset). Checks: container, codec, profile, pixel format, even dimensions, exact fps and platform fps range, duration bounds, byte floor and cap, bitrate range, BT.709 tags, faststart atom order, no audio, GIF infinite-loop extension, full decode. Fix the source of a failure (usually the composition or the storyboard), never the checker.

  1. Hand off: file paths per preset, the checker's summary, and the platform notes

below. Next: animation-frame-qa looks at the frames before delivery.

Output spec

  • out/<preset>.mp4 or .gif per requested preset, plus out/masters/*.mp4.
  • check_output.py exits 0 for every deliverable.
  • The reply states, per file, where it is meant to go and any handling note

(PowerPoint: insert, Start Automatically, Loop until Stopped for loops, do not run Compress Media; LinkedIn: upload the MP4, add the credit line from ATTRIBUTION.md to the post text if one exists; GIF: README/email/desktop decks only).

Gotchas

  • LinkedIn's video platform does not accommodate animated GIFs, and PowerPoint for

the web cannot play them. GIF is for README, email and desktop decks.

  • PowerPoint on Windows and Mac plays H.264/AAC MP4; HEVC, VP9 and ProRes are not in

Microsoft's supported list, WebM needs an extension, and alpha video is not a documented insert format: bake the slide background colour into the render.

  • Compress Media (Windows only) re-encodes to 1080p/720p/480p and drops embedded

subtitles; tell the presenter to leave it off.

  • Remotion tags only the colour matrix; primaries and transfer are tagged in the

ffmpeg pass (h264_metadata bitstream filter). Untagged video reads as BT.601 in some players and brand colours shift.

  • LinkedIn re-encodes: CRF 18 is this skill's policy for the upload; thin saturated

strokes and long gradients are what break in the re-encode, not bitrate. The checker also enforces LinkedIn's 75 KB and 192 Kbps floors that sparse vector clips can miss.

  • 4K for PowerPoint is --scale 2 on the 1080p composition, not a bigger design;

everything scales because tokens are fractions of the frame.

  • Rendering at 60 fps doubles time and no target requires it; keep the storyboard's fps.
  • Remotion's free license covers individuals, companies of up to 3 people and

non-profits; the renderer stops without a recorded basis (remotion.pro/license).

Pointers

  • assets/presets.json — the presets with source URLs, dates and the reason for each value.
  • scripts/render.py — masters + checked deliverables; --input, --dry-run, --reuse-masters, --self-test.
  • scripts/check_output.py — per-preset checks against the project's storyboard; --self-test.
  • references/delivery-specs.md — LinkedIn, PowerPoint, GIF and encoding facts with sources.
来自同一仓库

更多 Skills

全部 Skills
paldom
社区

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. Use when the user asks to check, review, QA, proof or sign off a rendered mp4 or gif, whether text reads on a phone, or which frames flash or strobe. Not for rendering.

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日