overlay-fx-generator

Generates timed motion-effect card JSON from SRT subtitles for Overlay Studio.

98|22|Updated Sep 1, 2026
One-click install
npx skills add https://github.com/jeszhou/overlay-studio --skill overlay-fx-generator-jeszhou
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: overlay-fx-generator
Source: https://github.com/jeszhou/overlay-studio/tree/main/.agents/skills/overlay-fx-generator
Command: npx skills add https://github.com/jeszhou/overlay-studio --skill overlay-fx-generator-jeszhou

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Manually designing animated overlays for talking-head videos means picking effects, timing them to speech, and re-rendering on every change. This Skill reads an SRT subtitle file and produces a ready-to-import overlay JSON where card selection, timing, and pacing are derived from the actual transcript. ## Core Features & Use Cases - SRT-to-overlay orchestration: Parses subtitle timestamps, segments the script into chapters and semantic sections, then assigns cards from a fixed library of 20 effect types (chapter bars, stat counters, quote cards, timelines, bilingual captions). - Density, diversity, and layout rules: Enforces pacing constraints such as no adjacent identical card kinds, per-segment accent colors, and rhythm parameters computed from real SRT durations. - Lint self-check before delivery: Runs the overlay linter to catch placeholder text and out-of-range timestamps, and preserves user-set lintOff overrides. - Use Case: Export subtitles from a talking-head video, hand the SRT to your agent, and receive a video-overlay.json you import into Overlay Studio to preview, tweak, and export as a transparent MOV layer. ## Quick Start Give the agent your SRT subtitle file and ask it to generate an overlay JSON for Overlay Studio using this skill.

Frequently Asked Questions about overlay-fx-generator

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate video overlay effects from an SRT subtitle file?

Provide the SRT file to an agent running this skill and ask it to generate the overlay JSON. The skill parses timestamps, segments the script semantically, picks cards from a 20-type library, and outputs a JSON file you import into Overlay Studio.

What output format does the overlay generator produce?

It produces a versioned JSON file with a theme field and a cards array, where each card has an id, kind, start and end times in seconds taken from the SRT, and a params object. The file imports directly into Overlay Studio for preview and editing.

Can I specify which effect card to use for a specific line?

Yes. You can point to a quote from the transcript, a time range, or a content description and name the card kind. The skill honors these requests, re-times content from the SRT, and only rearranges automatically placed cards to avoid conflicts.

Does the overlay JSON work without the Overlay Studio app?

No. The JSON is designed for Overlay Studio (the motion-playground app in the same repository), which renders the cards, provides the visual editor, and exports the transparent MOV layer. The skill also relies on the app's lint command for validation.

Why does the generated overlay fail the lint check?

Lint errors typically come from placeholder text left in card params or card times exceeding the video duration. Errors must be fixed before delivery; warnings like flash cuts or empty gaps are advisory and can be listed for the user to review.