Communitygithub.com

lalimi/claude-reelsmith

Write, analyse and plan short-video scripts (Instagram Reels, TikTok, YouTube Shorts, 30–60 s) in four proven viral structures — contrarian insight with a named archetype, series episode with a cliffhanger, humor hook + list of N factors, and "the scenario of …" confession. Use when the user asks to "write a reel script", "give me reel ideas", "analyse this viral reel", "break this reel down", "turn this transcript into a structure", "make one like this reel", pastes a reel transcript, or wants to edit a reel that has no script yet. Triggers in any language (e.g. "напиши сценарій для рілса"). Writes flowing spoken text in the creator's own language (English, Ukrainian, …), checks it against a checklist, and hands a montage plan to reel-builder, talking-head-edit or reel-director.

What is claude-reelsmith?

claude-reelsmith is a Claude Code agent skill that write, analyse and plan short-video scripts (Instagram Reels, TikTok, YouTube Shorts, 30–60 s) in four proven viral structures — contrarian insight with a named archetype, series episode with a cliffhanger, humor hook + list of N factors, and "the scenario of …" confession. Use when the user asks to "write a reel script", "give me reel ideas", "analyse this viral reel", "break this reel down", "turn this transcript into a structure", "make one like this reel", pastes a reel transcript, or wants to edit a reel that has no script yet. Triggers in any language (e.g. "напиши сценарій для рілса"). Writes flowing spoken text in the creator's own language (English, Ukrainian, …), checks it against a checklist, and hands a montage plan to reel-builder, talking-head-edit or reel-director.

Works with✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/lalimi/claude-reelsmith/tree/HEAD/skills/reel-script

Ask in your favorite AI

Open a new chat with this agent skill pre-loaded.

Documentation

Reel script

A script that stops the scroll, narrows a broad human topic down to the creator's niche, and ends with exactly one action. The structures come from real viral reels; reference transcripts teach the shape only and are never reused.

First read references/facts.md. If it is still the blank template, ask for the product in one line, the accounts, and the script language, then fill it in.

Modes

1. Analyse a reel

Input: a transcript, a pasted script, or a link plus description.

  1. Split it into numbered beats, with timings if known.
  2. Name the device in each beat (device list in references/structures.md).
  3. Say in one line why it works.
  4. Match it to structure A–D. No match: write it up as a new structure in the same format, append it to references/structures.md, add an abstract beat map to references/examples.md, and tell the user it was added.

Store beats abstractly: paraphrase, at most a ~5-word illustration per beat. Never paste the source transcript into the reference files.

2. Write a script

  1. Account + language: from facts.md. If there are several accounts and the request doesn't say which, ask once. Write in the creator's language.
  2. Structure: pick from the table in references/structures.md. For "give me ideas": one idea per structure, one line each; write the full script only for the one chosen.
  3. Script: one flowing spoken text. Under it, the beat map (beat → time → sentence). Mark 4–8 accent words with <em>…</em>, numbers in digits.
  4. Checklist: run references/checklist.md and fix before showing. Never show a draft that fails it.
  5. Facts: product claims only from facts.md. Anything else goes in a "Confirm:" list at the end.
  6. Montage plan: 3–5 techniques from the menu below, each mapped to a beat. Add subtitle chunks of 5–7 words only if the editor needs them (reel-builder chunks automatically).
  7. Caption: one CTA, 3 hashtags, does not repeat the hook, follows the caption style in facts.md.

Full worked example: references/examples.md → "The eternal-draft scenario".

3. Series (structure B)

Keep episodes.md in the reel's project folder: episode number, topic, what the cliffhanger promised. The next episode must pay off that promise.

Voice rules

  • The creator's language, conversational, as if telling a friend. Full sentences that flow into each other.
  • No choppy one-word rhythm ("And you answer. For free. For years." gets rejected). A short line is allowed only as a punchline right after a longer setup.
  • Concrete over abstract: numbers, places, objects, times of day, named people ("Tanya from accounting"). Never "people", "many", "some".
  • One reel = one idea. Humor and self-irony welcome; at most one sharp or edgy phrase.
  • Length: 40–50 s ideal, 60 s hard cap. Time a read-aloud or the first voice take; slow TTS voices need ~15% fewer words.
  • Natural target language: no calques or translated-sounding phrases. When adapting from another language, localise names, prices and idioms.
  • On-screen text: no em-dashes.

Montage menu

Effects the reel-builder engine renders (key in reel.json). Use 3–5 per reel, big enough to read on a phone at first watch; real transitions on key cuts only, not every cut.

TechniqueBest onKey
Doodle boil (hand-drawn text, circles, strikes, arrows)confessions, ironic asidesdoodles
Glass type (frosted title card)the coined name, the series titleglass
Checklist (items tick in as spoken)steps, rules, list itemschecklist
Orbit (text ring around the speaker's head)one big number or goalorbit
Cover story + frame break (masthead behind the head)hookcover
Headline wall (tiles piling up)a pile of examples: files, messageswall
Zoom-through / whip cut4–6 beat changessegment in
Black-and-white → colour burstsad "before", then the turnsegment look
Punch-inaccent wordsautomatic, or punch
Pull-backthe closing linesegment move: "pull-out"

Hand-off

  • Voice-over over footage → reel-builder skill (reelsmith build). Pass the script with <em> accents, the beat map and the montage plan.
  • Talking to camera → talking-head-edit skill. The script is what the creator says; the beat map tells the editor where layouts and cards change.
  • Creative review → reel-director skill, on the script before recording or on the first cut.
  • Keep every on-screen element inside the Reels/TikTok safe zone.

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

lalimi/claude-reelsmith

Build a finished voice-over reel (Instagram Reels / TikTok / Shorts, 1080×1920, 25–70 s) from one reel.json — the creator's own clips and photos + a voice-over + subtitles with accent words + hook/end cards, stamps, punch-ins, transitions and motion effects (cover story, orbit text, doodle boil, glass type, checklist, headline wall, black-and-white → colour burst, photo montage), music bed, −14 LUFS mix, safe-zone QA sheet, cover and caption. Use after a script is approved (reel-script skill) when the reel is a voice-over over footage (for someone talking to camera use talking-head-edit), or when asked to "make / build / rebuild / re-cut a reel", "змонтуй рілс", "перезбери".

lalimi/claude-reelsmith

Finish a built reel in CapCut — upload the picture (everything baked in), the voice and music stems, place CapCut library sound effects on every effect and transition, push an editable CapCut Web draft, and let the creator swap music and sounds by ear before exporting. Uses the CapCut MCP connector bundled with this plugin. Use when asked for "sound effects from CapCut", "put it into CapCut", "editable draft", "change the music in CapCut", "капкат".

lalimi/claude-reelsmith

The director of a reel made from the creator's own footage — runs the whole job from idea to a post-ready MP4 + cover + caption and makes the creative calls (which story structure, which 3–5 effects go on which beat, where the transitions are, pacing, sound), then reviews the cut like a critic before handing it over. Use when someone says "make me a reel", "turn my clips into a reel", "edit this like a pro", "what do you think as a critic / director", "make it more alive", "add effects", "зроби рілс", "що скажеш як критик", or when a reel is being planned, reviewed or re-cut.

Related Skills