One number explains everything (hero digit → ramp → meaning)#

Template (assume duration 10 unless scaled): 0–3s this number explains it all (user names which metric conceptually—caption stays short); 3–8s number grows / graph ramps— motion must not stop (tickers, bars, globe wireframe); 8–10s one conclusion line (user-themed). English subtitles with exact windows. Default duration is 10 when unspecified.

Dependencies: WERYAI_API_KEY + Node.js 18+. scripts/video_gen.js + WERYAI_VIDEO_API.md. No other Cursor skills required.

Prerequisites#

• WERYAI_API_KEY must be set; Node 18+. Prefer public https image URLs; if the assembled scripts/video_gen.js supports local file paths, review/verify the script and explicitly consent before local read-and-upload to WeryAI.
• Non-empty model.

Security, secrets, and API hosts#

• WERYAI_API_KEY: Secret; never commit.
• API hosts fixed in video_gen.js.
• Local image handling disclosure: Prefer public https image URLs. If the assembled scripts/video_gen.js supports local file paths, it may read a local image and upload it to WeryAI to obtain a public URL; require review / verification and explicit consent before using that path.
• Higher assurance: Prefer a short-lived or isolated environment; review scripts/video_gen.js before production use. Verify whether the runtime can read local image files and upload them to WeryAI, and obtain explicit consent before using that path.

Prompt expansion (mandatory)#

• Duration: Default 10; 5 or 15 when allowed and requested.
• Timeline scaling: Rescale 0–3 / 3–8 / 8–10 proportionally; keep hook → ramp → meaning order.

Locked rhythm (example for duration 10):

• 0.0–3.0s — Hook: e.g. THIS NUMBER EXPLAINS EVERYTHING (or embed the name of the metric in ≤6 words).
• 3.0–8.0s — Ramp beat—split into two on-screen lines if needed ( 3–5.5 WATCH IT CLIMB, 5.5–8.0 FASTER THAN YOU THINK)—customize to user tone.
• 8.0–10.0s — Meaning: e.g. HERE’S WHAT IT MEANS (user supplies specific kicker in brief—you compress to ≤6 words).

Visuals: Giant numeral, neon graph, motion blur streaks, particles; refresh chart at least every ~1s.

Typography: Huge readable words + numeric; outline; lower third for sentences, center for hero digit moments if described.

Negatives (Kling): garbled digits, illegible captions, watermark.

Confirmation: Full prompt.

Niche checklist#

• If real stats matter to the user, they must approve final wording—you still compress for on-screen limits.
• Avoid fake precision—prefer “illustrative counter” language in prompt if not citing sources.

Workflow#

1. Text / image / multi-image ( SEEDANCE_2_0, ≤3).
2. Collect which metric / metaphor.
3. Expand → validate → confirm → wait.
4. [Video](url).

CLI reference#

sh

node scripts/video_gen.js wait --json '{"model":"KLING_V3_0_PRO","prompt":"…","duration":10,"aspect_ratio":"9:16","generate_audio":true,"negative_prompt":"illegible text, garbled numbers, watermark"}'
node scripts/video_gen.js wait --json '{"model":"SEEDANCE_2_0","prompt":"…","duration":10,"aspect_ratio":"9:16","resolution":"720p","generate_audio":true}'

Full reference: WERYAI_VIDEO_API.md.

Definition of done#

Video or error; hook / ramp / meaning subtitle structure explicit in prompt with second ranges scaled to duration (or user-approved subdivision).

Boundaries (out of scope)#

• Not a data journalism vetting pipeline.
• resources/WERYAI_VIDEO_API.md for CLI; no negative_prompt on Seedance.
• Multi-image only SEEDANCE_2_0, max 3.

Example prompts#

• Metric: compound growth—counter ramp, meaning about time
• Metric: attention minutes per day—punchy closer
• Chart image URL → animate growth with same windows
• Inflation or CPI vibe—counter climbs, meaning line about purchasing power

---

Model and API constraints (frozen for this skill)#

Text-to-video#

model_keydurationsaspect_ratiosresolutionsaudionegative_promptprompt limitKLING_V3_0_PRO5, 10, 159:16, 1:1, 16:9_(omit)yesyes2000KLING_V3_0_STA5, 10, 159:16, 1:1, 16:9(omit)_yesyes2000SEEDANCE_2_05, 10, 159:16, 1:1, 16:9480p, 720pyesno2000

Image-to-video#

model_keydurationsaspect_ratiosresolutionsaudionegative_promptimage slotsKLING_V3_0_PRO5, 10, 159:16, 16:9, 1:1_(omit)yesyessingle imageKLING_V3_0_STA5, 10, 159:16, 16:9, 1:1(omit)_yesyessingle imageSEEDANCE_2_05, 10, 159:16, 1:1, 16:9480p, 720pyesnoup to 3 images

Recommended models#

Tiermodel_keyDefault duration⭐ BestKLING_V3_0_PRO10👍 GoodKLING_V3_0_STA10⚡ FastSEEDANCE_2_010 ( resolution: 720p)

Default parameters#

FieldValueaspect_ratio9:16duration10generate_audiotrueresolution720p (Seedance)negative_promptKling: illegible text, garbled numbers, watermark

Text-to-video (primary)#

User gives topic for the number → you craft three beats → confirm.

Image-to-video (optional)#

Static chart → ramp animation + captions.

Tips#

• Sound: describe tick + whoosh—helps perceived pacing.
• Translate user Chinese brief to English on-screen lines unless specified.

Packaged as one-number-explains-video-gen.