> ## Documentation Index
> Fetch the complete documentation index at: https://docs.snowdoughnut.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Yapper Framework

> The skill that turns a story, a product, and a few answers into a fully scripted yapper ad: a beat table, the word-for-word script, and three hook variants to test.

Writes a yapper ad script: one relatable person, talking to camera, telling the story of how they came round to a product. You answer a few questions, mostly by picking options, and get back a beat table, the full script, and three alternate openings.

Based on Harry Delmege's talk, [The Anatomy of a Yapper Ad](https://www.youtube.com/watch?v=7zCLVmZCoQQ) (Roly Poly Digital, published by Motion). Written up here in our own words.

## What a yapper ad is

A yapper is a **relatable hero** who went through something, came out the other side because of a product, and is now telling you about it the way they would tell a friend on FaceTime. The ad is a story first and a sale second.

It competes with organic posts, not with other brands' ads. People scroll to be entertained, and a story is the oldest way to hold attention.

Two things are not a yapper ad:

* **A basic problem-and-product script with no story**, even when it is filmed in a car.
* **An unscripted ramble.** Yapper ads are fully written.

## When it runs

Ask for a yapper script, a storytelling UGC ad, a talking-head testimonial-style script, or hand over a story and a product and ask for an ad. It also covers breaking down a winning yapper ad you paste the transcript of.

It writes the script. The edit is the [video editing](https://docs.snowdoughnut.com/skill-video-editing.md) skill's job, and the shot list and creator brief come from [ad creation](https://docs.snowdoughnut.com/skill-ad-creation.md).

## The six rules it enforces

**1. Fully script it, leave room to be human**

The copywriter writes every line; the creator makes it believable. Bullet points hand the copywriter's job to the creator. The script still marks one place for a small natural slip (fumbling for the free gift, losing the word), because a perfect delivery reads as selling.

**2. Story first, product woven in**

The product can enter early or three minutes in, but it never lands mid-story with every benefit at once. Story and product weave in and out.

**3. The Oracle makes the big claims**

Someone in the story introduces the product to the speaker: a doctor, a friend, an aspirational neighbour. The Oracle can say what the speaker cannot without sounding like a salesperson, and the speaker just relays it. "I found this scrolling" is never the introduction.

**4. Believable beats wild**

Wild stories pull engagement; believable ones sell. A timeline (nothing on day one, something by week one, the real change by month three) keeps the result credible and sets up continued use.

**5. Yap, don't waffle**

Start in the story. Context the viewer does not need to follow it gets cut. A yapper is as long as the story needs and not a line longer.

**6. Sell at the end**

After the viewer has stayed this long, ask for the sale: the offer told as the speaker's own experience, real scarcity, the guarantee, and a warning off knockoffs when the product is not sold on Amazon.

Every claim, whoever says it in the story, stays inside the approved claims table in [messaging](https://docs.snowdoughnut.com/messaging.md). A first-person story is an endorsement, so health, results, and before-and-after claims route through the [legal review](https://docs.snowdoughnut.com/legal-review-process.md) trigger table like any other ad.

## Who can sell anything

Three kinds of speaker can sell a product to anyone. The skill writes the Convert by default.

| Speaker | Who they are | Example |
| :- | :- | :- |
| Convert | Had an experience, changed their mind, now believes completely | "I swore I'd never pay for this, and now I won't go without it" |
| Expert | Knows more than the viewer: a doctor, a derm, or an insider like someone's assistant | "I work for a family who all take this" |
| Friend | Recommends because they care, no credentials needed | "Honestly, just try it" |

The Convert is the yapper because conversion is a story by definition: where they started, what happened, and what life looks like now. Belief that strong is hard to argue with and easy to watch.

## Finding the story

The story comes before the script. Look where people tell stories freely:

* **Reddit**, because people are anonymous and say anything. Broad, busy subreddits beat niche ones; more traffic means more stories to retell with the product written in.
* **TikTok**, for the delivery. It shows how people actually tell a story or go on a rant, which is the reference for how the script should sound.
* **Customer reviews** work, but they are a narrow pool.

A story worth using passes three tests:

| Test | What to check |
| :- | :- |
| Believable | It has happened to the viewer or someone they know, or they fear it will. A bad dentist visit, not a heist |
| Wild enough | It makes someone say "that's nuts". Good for engagement, harder to sell from, so pair it with a strong timeline |
| Proven | Upvotes, comments, views. A story people already engaged with is a conversation already happening in the viewer's head |

## The hook

The opening hooks on three channels at once: what the viewer sees, what they hear, and the text on screen. Each script ships with all three.

**Visual.** A face to camera already stops the scroll; small movements in the first second help it more. Four that suit a yapper, alongside the wider list in [visual hooks](https://docs.snowdoughnut.com/visual-hooks.md):

* Hands coming together (no actual clap, it ruins the audio)
* Putting the hair up or down
* Getting into the car and shutting the door
* Propping the phone up as recording starts

**Audio and text.** The spoken line and the text on screen are written as a pair, from one of three types:

| Type | How it opens | Example | What it tends to do |
| :- | :- | :- | :- |
| Curiosity plus benefit | A gap the viewer wants closed, plus the result | "One change gave me my mornings back in three weeks" | Lower hook rate, higher-intent viewers. The lead variant |
| Biggest net | Speaks to as many people as possible, no product, no benefit | "Don't make the mistake I made" | Highest hook rate |
| Qualification | Names exactly who this is for | "Women over 50, this might be why you're tired" | Filters to the right viewer |

The three hook variants in the output are one of each, so the test reads cleanly. In [hook types](https://docs.snowdoughnut.com/hook-types.md) terms they file as curiosity, curiosity, and problem call-out.

## The body checklist

The body is not a fixed framework. It is a checklist of direct response beats, each one delivered inside the story:

| Beat | What it does |
| :- | :- |
| Oracle | Introduces the product and carries the big claim |
| Mechanism | How the product produces the result. The viewer's "oh, that's why it works" moment |
| Disqualify competitors | Why nothing they tried before worked: what the others lack. Often the Oracle says it |
| Objections, as they arise | The doubt the last line just raised gets answered in the next one. "I thought the high dose would wreck my stomach. It didn't" |
| Timeline | Day one, week one, month three. Earns belief and sets expectations for continued use |
| CTA | The offer as the speaker's own experience, real scarcity, the guarantee, the knockoff warning |

## Length

As long as the story needs. Winners run anywhere from 90 seconds to over four minutes, and older audiences sit through longer scripts than younger ones. The skill asks the audience age and lets the story set the length unless you name one.

## What it asks you for

Most questions arrive as a multiple-choice dialog, up to four at a time, with the recommended option first. Only the things that are yours to write come through chat: the story, the product's mechanism, the main objection, and the offer details.

| Dialog | Questions |
| :- | :- |
| The ad | Where it runs · who is watching · length · speaker type |
| The story | Story source · believable or wild · the Oracle · when the product enters |
| The close | What the CTA includes · timeline · visual hook · the planned slip |

Anything your setup, the [messaging](https://docs.snowdoughnut.com/messaging.md) page, the [customer profile](https://docs.snowdoughnut.com/b2-c-customer-profiles.md), or an attached brief already answers gets skipped.

## What you get

1. **The beat table.** Every beat in order with its rough timing, the visual, the spoken line, and the text on screen.
2. **The full script.** Word for word, as the creator will say it, with direction notes in brackets and the planned slip marked.
3. **Three hook variants.** Curiosity plus benefit, biggest net, and qualification, each with its spoken line, text on screen, and visual. Each swaps in for the first beat without touching the rest.

Plus a list of every claim in the script matched to its line in the approved claims table, and anything left unbacked flagged rather than written around.

The beat table runs like this:

| Beat | Time | Visual | Spoken | On screen |
| :- | :- | :- | :- | :- |
| Hook | 0:00 | Gets into car, shuts door | "Don't make the mistake I made." | Don't make my mistake |
| Story | 0:03 | Face to camera | Straight into the dentist visit | |
| Oracle | 0:40 | Leans in | Her neighbour, 72, looks 55. Asks her secret | |
| ... | | | | |
| CTA | 2:10 | Holds the product | The offer as she found it, the guarantee, skip the knockoffs | Link below |

## Break down a winner

Paste the transcript of a yapper ad that worked and the skill maps it instead of writing a new one: the big idea, the speaker type, the Oracle, each body beat with its timestamp, the hook type, and what made it feel new, easy, and safe to the viewer. The breakdown can then seed a new script on the same skeleton.

## Runbook

The run card an agent executes this skill from. The conversation follows [how the MCP talks](https://docs.snowdoughnut.com/mcp-conversation.md): closed-list questions in the multiple-choice dialog, batched up to four per dialog.

| Step | What happens |
| :- | :- |
| Trigger | A request for a yapper ad, a storytelling UGC script, or a talking-head story ad; or a winning ad's transcript with a request to break it down |
| Mode | Write a new script, or break down a winner. Infer from the request; ask in a one-question dialog only when unclear |
| How to ask | Every closed-list question goes in the multiple-choice dialog: up to four questions per dialog, two to four options each, recommended option first and labelled "(Recommended)". Free-text answers are asked in chat, one per turn, one or two sentences. Where no dialog is available, ask one question per turn in chat with the options listed |
| Dialog 1: The ad | Where it runs: Meta Feed and Reels, TikTok, YouTube Shorts, several. Who is watching: under 35, 35 to 50, over 50. Length: let the story decide (Recommended), about 60 seconds, 90 seconds to 2 minutes, 3 minutes plus. Speaker: Convert (Recommended), Expert, Friend. Skip any the brief or setup answers |
| Dialog 2: The story | Story source: I'll paste it, a Reddit or TikTok post, a customer review, draft one from the customer problem. Story feel: everyday and believable (Recommended), wild and surprising. The Oracle: an expert (doctor, derm, pro), a friend or family member, an aspirational neighbour or insider, no Oracle. Product enters: woven through (Recommended), early then woven back, late once the story lands |
| Chat asks | Only what the documents do not hold, one per turn: the story itself (unless drafting one); the mechanism and what competitors lack; the biggest objection; the offer (discount, guarantee length, whether it really sells out). Skip each answered by [messaging](https://docs.snowdoughnut.com/messaging.md), the customer profile, a [battle card](https://docs.snowdoughnut.com/competitor-battle-card.md), or the brief |
| Dialog 3: The close | CTA includes (multi-select): the sale or discount, real scarcity, the guarantee, the Amazon knockoff warning. Timeline: yes (Recommended for anything used over time), no. Visual hook: let Claude pick (Recommended), then the best-ranked options from the yapper four and [visual hooks](https://docs.snowdoughnut.com/visual-hooks.md). Planned slip: yes, mark one place (Recommended), no |
| Confirm | One line: speaker, Oracle, story, length, then write |
| Pulls | [Hook types](https://docs.snowdoughnut.com/hook-types.md), [messaging](https://docs.snowdoughnut.com/messaging.md) and its approved claims table, [brand voice and tone](https://docs.snowdoughnut.com/brand-voice-and-tone.md), the customer profile, the [angle brief](https://docs.snowdoughnut.com/angle-brief.md) when one exists, the [legal review](https://docs.snowdoughnut.com/legal-review-process.md) trigger table, and the placement's creative specs for ratio and caption-safe zones |
| Rules | The six rules above. Every claim traces to the approved claims table; an unbacked claim is flagged, never invented. A drafted story stays ordinary and believable, never presented as a real customer's words. Run the script past [de-AI writing review](https://docs.snowdoughnut.com/skill-deai.md) before delivering, since it will be spoken aloud |
| Output | The beat table, the full word-for-word script with direction notes and the planned slip, and three hook variants (curiosity plus benefit, biggest net, qualification), plus the claims list. Delivered to the copy location from setup. Offers [video editing](https://docs.snowdoughnut.com/skill-video-editing.md) once the footage exists |

## Related resources

* [Hook types](https://docs.snowdoughnut.com/hook-types.md) The wider hook list these three openings file into.
* [Messaging](https://docs.snowdoughnut.com/messaging.md) The approved claims every line of the script stays inside.
* [Ad creation](https://docs.snowdoughnut.com/skill-ad-creation.md) Turns the script into a creator brief and deliverables plan.
* [Video editing](https://docs.snowdoughnut.com/skill-video-editing.md) Cuts the filmed script per placement.
* [De-AI writing review](https://docs.snowdoughnut.com/skill-deai.md) The pass that keeps the script sounding spoken.
* [Skills](https://docs.snowdoughnut.com/skills-overview.md) How skills load and where they are installed.

> [accordion] MCP wiring
>
> **Type:** skill\
> **Domains:** copy, creative, video, meta, tiktok, youtube\
> **Provides:** `skill:yapper-framework`\
> **Uses:** `angle-brief`, `approved-claims`, `battle-card`, `brand-voice`, `creative-specs`, `customer-profile`, `hook-framework`, `hook-type`, `legal-triggers`, `messaging`, `visual-hook`\
> **Hands off to:** `skill:deai`, `skill:ad-creation`, `skill:video-editing`\
> **Best for:** channel: meta, tiktok, youtube; business: ecommerce, b2c; audience: cold; length: long\
> **Avoid when:** business: sales-led
>
> **Triggers:** "yapper ad" · "storytelling UGC script" · "talking-head story ad" · "break down this winning ad"
>
> **Output:** Beat table, word-for-word script, three hook variants, claims list

***

> [card] [Get the complete Marketing OS](https://snowdoughnut.com?utm_source=docs\&utm_medium=owned\&utm_campaign=docs-endcap\&utm_content=os-subscribe)
>
> Subscribe to Snow Doughnut, our free weekly newsletter, and get the Notion workspace where you do the work: tasks, a marketing calendar, name generators, briefs, and more.

> [card] [Have us run it for you](https://snowdoughnut.com/agency?utm_source=docs\&utm_medium=owned\&utm_campaign=docs-endcap\&utm_content=agency)
>
> We implement this system, use it to help you grow and scale, then hand it all off to you when you're ready.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.