Skip to content

ssheleg/super-ux / plugins/super-ux/skills/brand-voice

brand-voice

Verified

Use when defining or checking how a product speaks: tone of voice, terminology, canonical facts, register. Triggers: "tone of voice" / "тон оф войс", "brand voice" / "голос бренда", "брендбук", "наша терминология". Not for writing the text (copywriting). Refusal phrase "no brand" / «без бренда».

references/video-script.md

View on GitHub
# Video scripts: the angle, the structure, the timing and the shot list

A short video or a video ad is copy the viewer hears and reads at speed. This
file is how to write it: one angle, a modular hook, body and ask, a structure
chosen for the goal, timing measured rather than guessed, and a shot list the
editor can work from. The hook itself is [hooks.md](hooks.md); the platform
physics are [channel-playbooks.md](channel-playbooks.md#short-video); what to
study before writing is [research-outliers.md](research-outliers.md).

*Sources read 2026-10-07. Every rule names its source or is marked as
practice.*

## Contents

- [The angle in one sentence](#the-angle-in-one-sentence)
- [The modular anatomy](#the-modular-anatomy)
- [Organic structures](#organic-structures)
- [Ten ad structures](#ten-ad-structures)
- [Length and words per second](#length-and-words-per-second)
- [Pace, text on screen, sound](#pace-text-on-screen-sound)
- [Shot list and storyboard](#shot-list-and-storyboard)
- [The script document](#the-script-document)
- [Gates G2 to G4](#gates-g2-to-g4)
- [Reading the result](#reading-the-result)

## The angle in one sentence

Before any hook, write the angle as one sentence:

> For **[persona]**, who wants **[desire]**, we show **[proof]**.

- The persona comes from customer words (reviews, comments, tickets), ranked
  by how often and how strongly a need appears, not from who the ads are
  currently shown to: "The gap between who your ads target and who actually
  buys is the creative strategist's biggest opportunity"
  ([Dara Denney via Motion](https://motionapp.com/library/talk/dara-denney-stop-guessing-start-diagnosing-ad-creative-testing/)).
- The proof is a `facts.md` row, a screen, a customer's own words. No proof,
  no angle.
- A new angle differs from the ones already running on **at least two** of:
  persona, desire, format, speaker, message theme. "Same product filmed
  solving three different problems outlasts twenty colour variants of one
  angle" ([r/PPC](https://www.reddit.com/r/PPC/comments/1sc1mg7/), practitioner;
  the two-dimension grid is [Common Thread's](https://commonthreadco.com/blogs/coachs-corner/metas-new-creative-diversity-score-is-live-in-ads-manager-what-ecommerce-brands-must-act-on-now)
  recommendation, a vendor's).

## The modular anatomy

**Hook (about 10%), body (about 80%), ask (about 10%)**, each block
replaceable on its own, so one body can carry three to five hooks
([Segwise](https://segwise.ai/blog/creative-brief-template-performance-creative)).
Mark the three blocks in the script so a variant swaps one block and nothing
else.

For organic video the skeleton is: **hook (0–3 s) → stakes or setup
(3–8 s) → body with a visual change every one to three seconds → payoff →
loop or ask**
([`ig-reel/SKILL.md`](https://github.com/Jakeschincariol/instagram-agent-skill/blob/d03c56bb598be770c60b201f94237e5d1a4268a6/skills/ig-reel/SKILL.md):
0:00–0:02 hook, 0:02–0:07 stakes, one idea per beat, the last three seconds
for the payoff and one ask).

- **Pay off early**: the reward lands before about 70% of the running time
  ([r/NewTubers](https://www.reddit.com/r/NewTubers/comments/1uf54tv/), practitioner).
- **The loop**: the last line runs into the first, or the last frame matches
  the first, so a replay starts without a seam.
- **A reason to send it**: name the person it is for ("send this to the
  friend who…"), because sends are Instagram's strongest signal for
  non-followers
  ([Social Media Today, 2025-01-22](https://www.socialmediatoday.com/news/instagram-shares-algorithm-insights-2025/738034/)).
- **Write to one person.** A video for "the audience" is forwarded to nobody
  ([r/InstagramMarketing](https://www.reddit.com/r/InstagramMarketing/comments/1t3l41e/), practitioner).
- **The author's contribution is in focus** when other people's material
  appears: voice-over, commentary, green screen. Instagram's originality rule
  of 2026-04-30 removes recommendations otherwise
  ([channel-playbooks.md](channel-playbooks.md#short-video)).

## Organic structures

| Structure | Skeleton | Strong for |
|---|---|---|
| In medias res | the climax → "three days earlier" → the resolution | personal stories, case studies |
| Problem, twist, fix | the pain → why the usual fix fails → the unexpected fix | teaching |
| Listicle | a number hook → items of 3–6 s → the strongest item last → loop | saves |
| Before and after, process | the result → the process in time-lapse → the result | visual niches |
| Myth bust | the myth → the evidence → the right way | expertise |
| POV skit | a situation → escalation → the punchline | sends |

Assembled from practitioner threads read on 2026-10-07, chiefly
[r/NewTubers](https://www.reddit.com/r/NewTubers/comments/1uf54tv/) and
[r/InstagramMarketing](https://www.reddit.com/r/InstagramMarketing/comments/1t3l41e/);
treat the table as practice and keep the structures that beat your own median.

## Ten ad structures

| # | Structure | Skeleton for 30 seconds | Note and source |
|---|---|---|---|
| 1 | Problem, agitate, solve | 0–3 s the pain in the viewer's words → 3–12 s what the problem costs → 12–24 s the product solving it, shown → 24–30 s the ask | the hook names the problem; the body makes its cost concrete before the product appears ([Segwise](https://segwise.ai/blog/creative-brief-template-performance-creative)) |
| 2 | UGC testimonial | a hook (not the testimonial) → personal story → the moment of discovery → result → recommendation | never open on the testimonial ([Sanchez via Motion](https://motionapp.com/library/talk/15-proven-ugc-ad-hooks-that-are-working-right-now-savannah-sanchez/)); only real reviews, disclosed |
| 3 | Demo | the product working from frame 0 → two or three benefits shown → the offer | Demo is among Motion's top formats by hit rate ([Motion visual formats](https://motionapp.com/library/research/creative-benchmarks-2026/top-visual-formats)) |
| 4 | Before and after | split → process → result → how to get it | a top format, restricted by policy in health and finance (same source) |
| 5 | Founder story | "I made this because…" → a problem from life → the solution → an invitation | leads in Health & Wellness; formats differ by vertical ([Motion, trends are not universal](https://motionapp.com/library/research/creative-benchmarks-2026/trends-are-not-universal)) |
| 6 | Three reasons | "Three reasons why…" → three blocks of 6–8 s → the ask | ([Sanchez via Motion](https://motionapp.com/library/talk/15-proven-ugc-ad-hooks-that-are-working-right-now-savannah-sanchez/)) |
| 7 | Us versus them | a split "them / us" on three criteria → the offer | among Motion's top formats ([Motion visual formats](https://motionapp.com/library/research/creative-benchmarks-2026/top-visual-formats)) |
| 8 | Offer first | the offer in frame 0 → proof → urgency, only when real | led Motion's 2026 benchmark, in a window overlapping Black Friday (same source) |
| 9 | Unboxing | the parcel → unpacking → first reaction → one detail | (same source) |
| 10 | Full funnel | one ad that works for cold and warm viewers alike | "Make the longest ad that you can that doesn't require any edits" ([Barry Hott via Alex Cooper](https://alexcooper.beehiiv.com/p/7-facebook-advertising-lessons-i-learned-from-barry-hott)) |

**Choose by vertical.** In Motion's 2026 data, Health & Wellness and Fashion
winners share almost no formats; start from your own vertical's, not from
someone else's feed
([Motion, trends are not universal](https://motionapp.com/library/research/creative-benchmarks-2026/trends-are-not-universal)).
Clear beats clever, and an ad that looks like the feed is read before it is
recognised as an ad (Barry Hott, same source as row 10).

## Length and words per second

English speech runs at about **2.5 words a second**: up to 3 when energetic,
about 2.2 when calm, 2 when conservative; for a cut with B-roll and pauses
plan on **2.0–2.3**
([Killer Spots](https://killerspots.com/blog/radio-script-timer-how-long-is-a-30-second-script);
[Fluxnote](https://fluxnote.io/guides/how-to-write-a-video-script)).

| Running time | Words (English) | Shots or cuts | Where |
|---|---|---|---|
| 6–8 s | 12–18 | 2–4 | a bumper, a hook test |
| 15 s | 30–38 | 5–10 | a short ad, a tight loop |
| 30 s | 60–75 | 10–20 | the standard ad |
| 45 s | 90–110 | 15–30 | a UGC story |
| 60 s | 120–150 | 20–40 | a teaching reel or short |
| 90 s | 180–220 | 30–60 | a deeper explainer |

**Russian and every other language: measure, do not convert.** Read the
script aloud, at the delivery you will record, against a timer, and cut until
it fits within ±10% of the target. This file carries no coefficient for
Russian: the research it draws on proposed one as its author's assumption,
and an assumption written into a table becomes a rule nobody re-measures.
The same holds for a synthetic voice: time the rendered audio, not the text.

## Pace, text on screen, sound

- **A visual change every one to three seconds**: a new shot, a zoom, B-roll,
  text. Clean cuts over over-editing; remove dead air longer than about half a
  second, keep the breathing (practice; the counter-view that jump cuts
  disorient is real, which is why the rule cuts air and not breath).
- **On-screen text**: the hook overlay is 5–10 words ([hooks.md](hooks.md#the-triple));
  subtitles run in short lines with only key words highlighted; everything
  sits inside the safe zone
  ([channel-playbooks.md](channel-playbooks.md#short-video)). TikTok's
  "5–10 words per second when using text" is the ceiling for how fast text
  may appear, not how much may stand on screen
  ([TikTok creative best practices](https://ads.tiktok.com/help/article/creative-best-practices?lang=en)).
- **Check subtitles against the approved script by transcription**: a
  synthetic voice can change a word, and the subtitle then quotes something
  nobody approved ([r/SideProject](https://www.reddit.com/r/SideProject/comments/1wf474o/), practitioner).
- **Sound carries TikTok** (same TikTok source), yet the first three seconds
  must work muted. A trending sound earns no confirmed bonus and no penalty;
  use one when it fits the meaning.

## Shot list and storyboard

One row per shot. The script is not finished until every row is filled:

| # | Timecode | Length | Framing | In frame | Camera | On-screen text | Voice line | Sound | Source | Accept when |
|---|---|---|---|---|---|---|---|---|---|---|
| 1 | 0:00 | 2 s | CU, screen | the bank app, scrolled to the charge | static | `$400 A MONTH, GONE` | "You lose $400 a month to one subscription you forgot." | notification ping | screen capture | the figure is legible on a phone |
| 2 | 0:02 | 5 s | MS | hand sorting the statement | push in | — | "Every month it renews, and nobody opens it." | room tone | shoot | the hand and the screen are both in focus |

- **Framing** is CU, MS, WS, insert or screen. **Source** is shoot, stock or
  generated; a generated shot names the model and its reference images, and
  each character, outfit and location is frozen and versioned before any
  shot is generated from it
  ([r/generativeAI](https://www.reddit.com/r/generativeAI/comments/1u8fulg/), practitioner).
- **Accept when** is checkable by someone who did not write the script.
- A storyboard is the same rows with a sketch or a keyframe per shot. Approve
  pictures, not prose: a reviewer reading a table approves a different video
  from the one that gets cut.

## The script document

A script lives in the project's marketing sources on the `short video`
surface (or the platform's own surface), with the triple in front matter so
the linter reads it:

```markdown
---
surface: short video
title: Forgotten subscriptions
hook: You lose $400 a month to one subscription you forgot.
hook-2: Your bank app hides the charge you forgot.
on-screen: $400 A MONTH, GONE
---

## Beats

0:00 Hook. Open on the bank app, scrolled to the charge.
0:02 Stakes. Every month it renews, and nobody opens it.
…
0:27 Ask. Send this to the friend who still pays for that gym.
```

`B044` filters every `hook` and `hook-N`, and on-screen text over ten words;
`B030` asks for a `facts.md` row for every figure in them, as in the body;
`B066` reports invisible characters pasted in from anywhere.

## Gates G2 to G4

Run in order; a gate that fails sends the work back one step, not forward.

**G2, the angle**
- [ ] One sentence: for [persona], who wants [desire], we show [proof].
- [ ] The proof exists: a `facts.md` row, a screen, a customer's words.
- [ ] It differs from the angles already running on at least two dimensions.

**G3, the hooks**
- [ ] Five to ten variants of **different mechanisms**, not five rewordings
      of one ([hooks.md](hooks.md#taxonomy)).
- [ ] Each is a triple: frame 0, on-screen text of ten words or fewer, first
      line.
- [ ] Meaning in frame 0; text by about 0.5 s; understood muted; the topic
      clear; tied to the product; the body pays it; nothing unsourced; no
      other platform's watermark.
- [ ] `B044` filtered the spoken lines. The survivors are chosen by a person
      and then by the retention chart, never by the score.

**G4, the script**
- [ ] A structure chosen for the goal and the vertical.
- [ ] Hook, body and ask marked as blocks.
- [ ] Read aloud against a timer, within ±10% of the target length.
- [ ] Every claim has its source; no fabricated testimonial.
- [ ] The humanization pass ran ([ai-tells.md](ai-tells.md)) and the status
      line is printed; one named person the video is for.
- [ ] The brand linter exits clean on the script document.

## Reading the result

| Signal | Where | What it means | Change |
|---|---|---|---|
| A cliff in 0–3 s | Instagram Skip Rate, Shorts "stayed to watch", Meta hook rate | frame 0 or the first line failed | the hook, not the body |
| A good start, a drop mid-video | the retention chart | the body does not pay the promise, or it sags | cut the setup, move the payoff earlier, break up the monologue |
| A good start, low completion | Shorts average percentage viewed, Meta hold | the hook worked and the body did not | rewrite the body to the hook's promise |
| Average percentage viewed above 100% | Shorts | replays: the loop works | repeat the structure |
| A step down before the ask | any | the ask reads as an ad | shorten it, fold it into the payoff |
| Views without follows | Instagram, TikTok | people watch the format, not the author | add the author's identity and a series |

Source: practitioner threads read on 2026-10-07, chiefly
[r/NewTubers](https://www.reddit.com/r/NewTubers/comments/1uf54tv/) and
[r/InstagramMarketing](https://www.reddit.com/r/InstagramMarketing/comments/1wlok7b/).
Thresholds start from the median of your own last ten videos, with the formula
written beside each number ([hooks.md](hooks.md#testing-hooks)).
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 196kUpdated Claude CodeCodexVerifiedInstall