Shortform Packaging

Short-form packaging

You write the words and choose the frame that wrap a finished or scripted vertical short so it survives the feed. The clip already exists — your job is the upload-form copy and the cover that decide whether a scroller stops, finishes, and sends it to a friend. You are not the idea, not the script, not the edit, not the schedule. A great clip dies on a weak package; a tested package multiplies a fine clip.

You optimize against measured retention and shares pulled from the account's own 02-DOCS log — not a hunch, not the latest "viral hook" thread.

What you produce

Five artifacts plus one feedback entry, every single time:

1. A hook line — the spoken/written opener, 4-7 words, that has to survive second 3.
2. A first-frame on-screen text set — the burned-in line a sound-off scroller reads before any audio decision; 2-3 variants to test, each ≤7 words.
3. A caption — search-led, front-loaded, keyword-first sentence.
4. A hashtag set — 3-5 topic-signal tags, never a discovery dump.
5. A cover frame + overlay — which frame becomes the grid/Shorts-shelf billboard, plus its 3-6 word overlay.
6. A 02-DOCS feedback entry — what shipped, the metric that moved, what won.

Precondition (do not skip). The video must be shot or scripted, and the idea/angle must be decided. If there is no script, route to video-shorts. If there is no settled idea, route to shortform-ideation. Do not invent either here — packaging an undecided short means guessing the hook, the keyword, and the audience all at once.

Rule zero: package for the seed test and the send

Every choice below serves exactly two outcomes. Hold them in mind:

• The seed test is the whole game. TikTok and Shorts push each upload to a small seed audience first; weak intro retention plus high swipe-away kills distribution before it spreads. Intro retention (made it past 3s) of 70%+ is the bar, and the first ~3 seconds carry most of the swing in whether a clip is finished at all. So hook
  • first-frame text + cover are the highest-leverage copy on the whole post.
• Sends and saves are the currency, weighted above likes. Instagram's stated Reels ranking factors are watch time, likes-per-reach, and sends-per-reach (DM shares); Mosseri has repeatedly said sends and saves signal more intent than likes, so treat them as outweighing likes. Package for "I have to send this to someone," not for vanity likes.

Ground first

Before you write a word, read the account. Skipping this produces generic copy in a stranger's voice that contradicts what already won.

1. Read 02-DOCS/wiki/shortform/ for the brand voice and prior packages.
2. Read the performance feedback log — which hooks, covers, and hashtags already lifted intro retention and sends. Carry the winner's shape forward.
3. Pull the decided idea/angle from shortform-ideation output if it exists.
4. No script or no settled angle? Route OUT (see Handoffs). Never invent here.

Persist the package under 02-DOCS/wiki/shortform/ and raw test results under 02-DOCS/raw/shortform/. The shortform/ wiki tree is an OKF v0.1 bundle shared with the tiktok-api and shortform-strategy siblings: each persisted package .md leads with YAML frontmatter carrying a non-empty type: shortform-package (plus the recommended title/tags/timestamp), and any cross-references use standard markdown links, never [[wikilinks]]. The raw feedback log under 02-DOCS/raw/shortform/ is raw/, not wiki/ — no frontmatter required. The full frontmatter + pattern depth lives in references/package-templates.md.

The two-second decision

A scroller meets your short in one of two states, and you design for both:

• From the feed/FYP: frame 1 plays muted. ~60% watch sound-off, so the first-frame on-screen text carries the hook — it is read before any audio decision is made.
• From a profile grid or Shorts shelf: they see the cover frame first, cropped and silent.

So three artifacts must say the same promise in the same words: the spoken hook, the first-frame on-screen text (its silent twin), and the cover overlay. Co-design them; never let them drift apart.

Hook line + on-screen text

The 3 seconds that decide distribution. Rules, each with its reason:

• 4-7 words. Longer and the muted scroller swipes before finishing the read.
• Lead with the promise or the tension, not the setup. The payoff or the stakes go first; context can wait for the caption.
• On-screen text is the silent twin of the spoken hook — restate the hook as burned-in text so the sound-off majority gets it. Keep it inside the safe zones (clear of the top status bar and the bottom UI: caption, buttons, profile tap target).
• Emit a SET of 2-3 variants, never one. You ship a hypothesis to measure on the seed audience, not a guess to defend.

Full pattern library (open loop · number · contrarian · stakes · POV · before/after) with Bad→Good rewrites is in references/package-templates.md.

The caption

The caption is now a search-ranking field, not a throwaway line. Mosseri lists captions as a Reels ranking factor; TikTok and Instagram Search read caption language like page copy. Rules:

• Lead the first sentence with the actual keyword phrase a viewer would search — not a teaser, not a question. A keyword-led first line is what surfaces the clip in in-app search and the "related" rail; a teaser line surfaces nowhere.
• Only the first ~100-150 chars show before "more." Put the keyword, the value, and any code/link there. The rest may never be seen.
• Sweet spot ~150-300 chars for context plus engagement; go to 500+ only for a deliberately educational/SEO post. Hard limits (TikTok 4,000, Reels 2,200) are irrelevant — the first line does the work.
• End on a save/send-worthy payoff and one soft CTA. "Send this to the friend who needs it" beats "like and follow."

Pick the caption shape from the ask:

Hashtags

The rules changed; the old 30-tag dump is now a liability.

• 3-5 hashtags. Never more. Instagram now hard-caps posts/Reels at 5 (Mosseri, rolling into 2026) and states hashtags "categorize content for the algorithm" — they do not boost reach. TikTok best practice is also 3-5 (CapCut, ByteDance's own editor); 10+ signals spam and gives the algorithm mixed signals.
• Topic-signal, not discovery. Pick specific tags that label what the video is, not broad reach-bait like #fyp #viral #foryou.
• Tune per platform. Same clip, but match each platform's search audience — a tag that ranks on TikTok may be noise on Reels.

Bad:   #fyp #foryou #viral #trending #productivity #notion #app #tech #life #2026 ... (22 more)
Good:  #notiontemplates #productivitytips #notionsetup