Index of every page on this site: llms.txt
All skills
Run it yourself

This skill should be used when the user asks to "make a Spotify Wrapped style video", "build a year in review / year-in-review video", "create a personalized data video", "generate a recap video", "build a wrapped video generator", "turn a data table into shareable videos", or "make per-user stat videos". Covers the data row → one shareable video pattern, the Wrapped scene grammar (big-number reveals, top-X lists, superlatives), animated data counters, vertical 9:16 framing, and batch-rendering many personalized videos from one template.

Use this Skill: https://skilld.dev/gh/authrain-cloud-abdullahformuli/explainer-video-skills/wrapped-video

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

referencesscene-grammar.md

≈1.2k tokens on demand. Your agent reads this file only when SKILL.md points to it.

Scene grammar: the Wrapped storyboard

A Wrapped is not a freeform film. It is a fixed sequence of short, reusable scene types, each a slot a data row fills. Lock the grammar once; only the data and palette change each year. This is why one template scales to millions of personalized videos.

The crescendo

Order scenes so personal stakes rise toward a climax, then resolve on a still share card:

  1. Context first — small, framing facts ("you listened on 287 days").
  2. Build — top-X lists, genres, time patterns.
  3. Climax — the single most personal/impressive stat (the percentile, the hero number), held longest and largest.
  4. Resolve — outro share card, motion settles to a clean freeze.

Never open on the biggest number; there is nowhere to go after it. Never end on motion; the last frame must be a clean, screenshot-ready card.

A full 7-scene storyboard (22s @ 30fps = 660 frames)

# Scene Frames Sec Beat
1 Intro: "{name}, your {year} wrapped" 0–90 0–3 Brand + palette set
2 Big number: minutes listened 90–210 3–7 First count-up, hero scale
3 Top-5 artists, staggered 210–330 7–11 Ranked list builds 1→5
4 Top genre / persona card 330–420 11–14 "You're an Indie Explorer"
5 Percentile: "top {x}% of listeners" 420–540 14–18 Bar fills, climax stat
6 Peak month / heatmap 540–600 18–20 "March was your month"
7 Outro share card (holds still) 600–660 20–22 Logo + handle + CTA, frozen

Scale by stretching/trimming the montage scenes (3–6), never the intro or the count-up payoffs. For 15s, drop scenes 4 and 6. For 45s, add a second list (top tracks) and a comparison scene.

Scene-type recipes

Intro. Big name + year, palette wash. One line of motion: name slides/fades up over a gradient using the per-user accent. Sets the visual identity for the whole film.

Big-number reveal. One number, oversized (180–240px), counts up with a spring, label below. Nothing else on screen. This is the most-shared scene type — give it room.

Top-X list. Ranks 1→5 enter staggered (rank 1 first), each {rank, label, value}. Rank number small and accent-colored, label bold white, value muted. The stagger is the animation; keep each row's motion identical.

Superlative / persona. Map data to a named archetype ("Indie Explorer", "Night Owl", "Top Fan"). Compute the label from thresholds so it personalizes automatically. Big label, one supporting line.

Comparison / percentile. "More than 92% of listeners." A horizontal bar fills to percentile, number counts up alongside. Strongest dopamine scene — usually the climax.

Time / peak. "Your busiest month was March." A simple 12-bar mini-chart with the peak bar in accent, others muted. Reads instantly even frozen.

Outro share card. Holds completely still ≥2s. Name, @handle, product logo, short CTA/URL. No competing motion. This frame is the share asset — design it as a poster.

Copywriting patterns (data → words)

Generate headline copy from the data, not hand-written per user:

  • Superlative tiers: percentile <= 1 ? "Top 1% — you're a superfan" : percentile <= 10 ? "Top 10%" : "...".
  • Persona from dominant dimension: pick the archetype whose threshold the row clears (genre share, late-night ratio, diversity count).
  • Comparison framing: always "more than X% of {peers}" — concrete peer group beats abstract numbers.
  • Second person, present, short. "You listened to 412 artists." Not "The user listened to..." Each line ≤ 7 words so it fits one bold frame.

9:16 safe-area map

Render 1080×1920. Story/Reels/TikTok UI overlays the edges and the platform may crop.

Zone Region Rule
Top 12% 0–230px Avoid type; platform clock/handle/close-button sit here
Bottom 18% 1575–1920px Avoid type/CTA; like/share/caption UI sits here
Center 80% h ~230–1575px All numbers, names, lists, the share CTA
Horizontal center 90% w Keep big type off the left/right 5%

Place the single most important element at vertical center (~960px) — it survives every crop and is where the eye lands. Test by overlaying a TikTok/Reels UI mock and confirming no number is occluded.

Motion language

Keep one motion vocabulary across all scenes so the film reads as one piece: same spring config for entrances, same fade for exits, accent color used consistently for "the number that matters." Consistency makes speed feel like confidence rather than chaos. Per-scene component code is in remotion-recipes.md.

Source: SKILL.md on GitHub

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

No alerts1mo3 checks · Risk SAFE
  • Gen Agent Trust Hub1mo

    The skill provides a template and instructions for generating personalized 'Spotify Wrapped' style videos using the Remotion framework. It incorporates security best practices such as input validation via Zod. A low-severity finding is noted due to the ingestion of external data files, which is the primary function of the skill, and the dynamic rendering process common to motion graphics frameworks.

  • Socket1mo

    No alerts

  • Snyk1mo

    Risk: LOW · No issues

Signed by skilld at c6415d0. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub last month.

Steadyupdated 2 months ago
version
0.1.0

README badge

README badge for authrain-cloud-abdullahformuli/explainer-video-skills/wrapped-video