Social Media skill 07 of 13

Short Video Scripts SKILL.md

The Short Video Scripts skill makes Claude, Codex or another AI agent write scripts for 15 to 90-second vertical videos on TikTok, Reels, Shorts and LinkedIn. It keeps one idea per video, writes hook banks across types, picks structures from tutorials to stories, builds beat sheets with time, visual, on-screen text and voice-over, cuts ruthlessly, plans captions for sound off and prepares hook variations to test.

short-video-scripts/SKILL.md, version 1.0.0, 1,503 words.

Short vertical video (TikTok, Instagram Reels, YouTube Shorts, LinkedIn video) rewards one thing above all: holding attention. Viewers decide in a second or two whether to keep watching, and every slow moment loses more of them. Most brand videos fail because they start with a logo, explain context nobody asked for, cram in several messages or end without a reason to act. A good script fixes this before anyone picks up a camera.

This skill writes scripts for short videos from 15 to 90 seconds: hooks, structure, on-screen text, visuals and B-roll, voice-over, pacing, calls to action and variations for testing, across tutorials, stories, demos, myth-busting, testimonials and trends.

Operating principles

  1. One video, one idea. Several messages mean none is remembered.
  2. Hook first, context later. Open with the most interesting moment, claim or result.
  3. Show, don't just tell. Visual proof, demonstrations and faces hold attention.
  4. Write for sound off and sound on. On-screen text and captions carry the message either way.
  5. Earn the ending. Deliver the payoff, then give one clear next step.

Script structures

StructureFlowGood for
Hook, steps, resultClaim, 3 quick steps, show the resultTutorials
Problem, agitate, solvePain, why it's worse than it looks, the fixProduct demos
Before and afterShow the end, rewind to the start, show howTransformations
Myth, truth, proofCommon belief, correction, evidenceEducation
Story arcSituation, tension, turning point, lessonFounder and customer stories
List"3 things..." with a quick visual for eachTips and ideas
Reply to commentViewer question on screen, answerCommunity and FAQs

Script template

Title / idea:
Target viewer and platform:
Length: (e.g. 30 seconds)

| Time | Visual | On-screen text | Voice-over or dialogue |
| 0-2s | Result shot: clean white trainers | "Clean white trainers in 60 seconds" | "This works better than anything I've tried." |
| 2-10s | Step 1 close-up | "Step 1: dry brush" | "First, brush off the dry dirt." |
| 10-20s | Step 2 | "Step 2: paste" | "Mix baking soda and washing-up liquid..." |
| 20-27s | Step 3 and reveal | "Step 3: wipe" | "Wipe, and look at that." |
| 27-30s | Final shot | "Save this for later" | "Save this for next time." |

Caption (with keywords):
Sound or music notes:
Call to action:

When to use, and when not to

Use it for organic short video on any platform, creator briefs, product demos, explainers, recruitment videos and repurposing long content into clips.

Don't use it for paid ad creative testing in depth (the Performance Marketing ad-creative-testing skill) or long-form YouTube videos (youtube-seo-growth).

Inputs to ask for, in one message

  1. The idea, product or message.
  2. Platform and target viewer.
  3. Length and format constraints.
  4. Who appears on camera, and locations or props available.
  5. Brand voice and any claims rules.
  6. Examples of videos the brand likes.

Raw SKILL.md file

.md

This is the exact file agents read, including the credit header and licence notice. Save it as short-video-scripts/SKILL.md.

---
name: short-video-scripts
description: "Write scripts for 15 to 90-second vertical videos on TikTok, Reels, Shorts and LinkedIn: one idea per video, hook banks across types, structures from tutorials to stories, beat sheets with time, visual, on-screen text and voice-over, ruthless cutting, captions for sound off, one call to action and hook variations to test. Use whenever someone asks for a short video script, Reels script, TikTok script, YouTube Shorts script, video hooks, product demo video script, creator brief or turning long videos into clips."
license: CC-BY-4.0
metadata:
  author: Afeez Adebayo
  author_url: https://afeezadebayo.com
  author_linkedin: https://www.linkedin.com/in/afeez-adebayo/
  author_x: https://x.com/za_icon
  source: https://afeezadebayo.com/skills-md/marketing/social-media/short-video-scripts/
  category: marketing
  subcategory: social-media
  version: "1.0.0"
  created: "2026-10-10"
  updated: "2026-10-10"
---

# Short Video Scripts

Short vertical video (TikTok, Instagram Reels, YouTube Shorts, LinkedIn video) rewards one thing above all: holding attention. Viewers decide in a second or two whether to keep watching, and every slow moment loses more of them. Most brand videos fail because they start with a logo, explain context nobody asked for, cram in several messages or end without a reason to act. A good script fixes this before anyone picks up a camera.

This skill writes scripts for short videos from 15 to 90 seconds: hooks, structure, on-screen text, visuals and B-roll, voice-over, pacing, calls to action and variations for testing, across tutorials, stories, demos, myth-busting, testimonials and trends.

## Operating principles
1. **One video, one idea.** Several messages mean none is remembered.
2. **Hook first, context later.** Open with the most interesting moment, claim or result.
3. **Show, don't just tell.** Visual proof, demonstrations and faces hold attention.
4. **Write for sound off and sound on.** On-screen text and captions carry the message either way.
5. **Earn the ending.** Deliver the payoff, then give one clear next step.

## Script structures
| Structure | Flow | Good for |
|---|---|---|
| Hook, steps, result | Claim, 3 quick steps, show the result | Tutorials |
| Problem, agitate, solve | Pain, why it's worse than it looks, the fix | Product demos |
| Before and after | Show the end, rewind to the start, show how | Transformations |
| Myth, truth, proof | Common belief, correction, evidence | Education |
| Story arc | Situation, tension, turning point, lesson | Founder and customer stories |
| List | "3 things..." with a quick visual for each | Tips and ideas |
| Reply to comment | Viewer question on screen, answer | Community and FAQs |

## Script template
```
Title / idea:
Target viewer and platform:
Length: (e.g. 30 seconds)

| Time | Visual | On-screen text | Voice-over or dialogue |
| 0-2s | Result shot: clean white trainers | "Clean white trainers in 60 seconds" | "This works better than anything I've tried." |
| 2-10s | Step 1 close-up | "Step 1: dry brush" | "First, brush off the dry dirt." |
| 10-20s | Step 2 | "Step 2: paste" | "Mix baking soda and washing-up liquid..." |
| 20-27s | Step 3 and reveal | "Step 3: wipe" | "Wipe, and look at that." |
| 27-30s | Final shot | "Save this for later" | "Save this for next time." |

Caption (with keywords):
Sound or music notes:
Call to action:
```

## When to use, and when not to
Use it for organic short video on any platform, creator briefs, product demos, explainers, recruitment videos and repurposing long content into clips.

Don't use it for paid ad creative testing in depth (the Performance Marketing `ad-creative-testing` skill) or long-form YouTube videos (`youtube-seo-growth`).

## Inputs to ask for, in one message
1. The idea, product or message.
2. Platform and target viewer.
3. Length and format constraints.
4. Who appears on camera, and locations or props available.
5. Brand voice and any claims rules.
6. Examples of videos the brand likes.

## Workflow

### Step 1. Pick one idea
Write it in one sentence.

### Step 2. Find the hook
Write ten hooks across types (result, question, mistake, bold claim, relatable situation, visual surprise); choose the strongest two to test.

### Step 3. Choose a structure
Match to the idea: tutorial, story, demo, myth-busting, list.

### Step 4. Write the beat sheet
Time, visual, on-screen text and voice for every few seconds.

### Step 5. Cut ruthlessly
Remove anything that doesn't move the viewer forward; aim for a cut or change every few seconds.

### Step 6. Add on-screen text and captions
Short, readable, placed away from platform buttons.

### Step 7. Write the call to action
One action: save, follow, comment, send, visit.

### Step 8. Prepare variations
Two or three hooks or openings to test with the same body.

## Hook bank
| Type | Example |
|---|---|
| Result first | "From 6 days to 2: here's how we close our books now." |
| Mistake | "You're probably watering your plants wrong." |
| Question | "Why is your Wi-Fi slow in one room?" |
| Bold claim | "This is the only spreadsheet formula most people need." |
| Relatable | "POV: it's Sunday night and you haven't planned any meals." |
| Curiosity | "We tested 5 cheap headphones so you don't have to." |

## Pacing guide
| Length | Beats | Notes |
|---|---|---|
| 15 seconds | Hook, one point, payoff | Ideal for single tips |
| 30 seconds | Hook, 2-3 steps, payoff, call to action | Tutorials and demos |
| 60 seconds | Hook, story or 4-5 steps, payoff | Stories and deeper explainers |
| 90 seconds | Hook, setup, development, payoff | Only if the story holds attention throughout |
Change the visual every two to four seconds: a new angle, close-up, text card or B-roll.

## On-screen text rules
- Large, high-contrast text in the safe area away from buttons and captions.
- One short line at a time.
- Match the spoken words or summarise them.
- Keep the hook text on screen long enough to read.

## Filming checklist
- Vertical 9:16, steady phone, eye-level framing.
- Natural light facing the speaker.
- Clean audio (a small clip-on microphone helps).
- Extra B-roll of hands, products and results.
- Several takes of the hook.

## Testing hooks
Post the same body with different openings over a week or two, or use platform features that test variations, and compare average watch time in the first seconds and completion rate. Keep a hook library of winners for future scripts.

## Further reading
- TikTok Creative Center: https://ads.tiktok.com/business/creativecenter
- YouTube Shorts creator resources: https://www.youtube.com/creators/shorts/

## Edge cases and judgement calls
| Situation | What to do |
|---|---|
| No one on camera | Hands-only, screen recordings, text-led or voice-over videos |
| Complex products | One use case per video; series for depth |
| Regulated claims | Approved wording only; add required disclaimers |
| Repurposing long videos | Pick moments with a clear hook and payoff; reframe with on-screen text |
| Creator briefs | Give the idea, key message and must-avoid list; let creators use their style |

## Handoffs to related skills
- TikTok: `tiktok-organic`
- Instagram: `instagram-organic`
- YouTube Shorts and long form: `youtube-seo-growth`
- LinkedIn video: `linkedin-organic`
- Creators: `creator-employee-advocacy`
- Paid creative: the Performance Marketing `ad-creative-testing` skill

## Worked example
A project management app made 60-second product videos that opened with its logo and a list of features; most viewers left within two seconds. New scripts opened with relatable situations ("POV: three clients emailed asking for updates at once"), showed one feature solving one problem in under 25 seconds, used on-screen text throughout and ended with "follow for one project tip a week". Average watch time and completion rates rose sharply, and two videos became the account's best-performing content.

## Output format
```
# Short video script: <idea>, <date>
## One-sentence idea and target viewer
## Hook options (top two marked)
## Beat sheet (time, visual, text, voice)
## Caption and keywords
## Call to action
## Variations to test
```

## Common mistakes
- Opening with a logo or introduction.
- Several messages in one video.
- No on-screen text.
- Slow pacing.
- Endings with no clear action.

## Questions to ask before you script
- What single idea should viewers remember?
- What would make someone stop scrolling?
- What can be shown, not just said?

## Self-check before you answer
- Does the first two seconds earn attention?
- Is there one idea and one call to action?
- Are visuals and on-screen text planned beat by beat?
- Are hook variations ready to test?

---
Created by Afeez Adebayo, Marketing, SEO & Growth Expert
Website: https://afeezadebayo.com
LinkedIn: https://www.linkedin.com/in/afeez-adebayo/
X: https://x.com/za_icon
Source: https://afeezadebayo.com/skills-md/marketing/social-media/short-video-scripts/

Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). You may copy, share and adapt this skill, including for commercial use, as long as you credit Afeez Adebayo and link to the source URL above. Keep this notice in any copy or adapted version.

Workflow

Step 1. Pick one idea

Write it in one sentence.

Step 2. Find the hook

Write ten hooks across types (result, question, mistake, bold claim, relatable situation, visual surprise); choose the strongest two to test.

Step 3. Choose a structure

Match to the idea: tutorial, story, demo, myth-busting, list.

Step 4. Write the beat sheet

Time, visual, on-screen text and voice for every few seconds.

Step 5. Cut ruthlessly

Remove anything that doesn't move the viewer forward; aim for a cut or change every few seconds.

Step 6. Add on-screen text and captions

Short, readable, placed away from platform buttons.

Step 7. Write the call to action

One action: save, follow, comment, send, visit.

Step 8. Prepare variations

Two or three hooks or openings to test with the same body.

Hook bank

TypeExample
Result first"From 6 days to 2: here's how we close our books now."
Mistake"You're probably watering your plants wrong."
Question"Why is your Wi-Fi slow in one room?"
Bold claim"This is the only spreadsheet formula most people need."
Relatable"POV: it's Sunday night and you haven't planned any meals."
Curiosity"We tested 5 cheap headphones so you don't have to."

Pacing guide

LengthBeatsNotes
15 secondsHook, one point, payoffIdeal for single tips
30 secondsHook, 2-3 steps, payoff, call to actionTutorials and demos
60 secondsHook, story or 4-5 steps, payoffStories and deeper explainers
90 secondsHook, setup, development, payoffOnly if the story holds attention throughout

Change the visual every two to four seconds: a new angle, close-up, text card or B-roll.

On-screen text rules

  • Large, high-contrast text in the safe area away from buttons and captions.
  • One short line at a time.
  • Match the spoken words or summarise them.
  • Keep the hook text on screen long enough to read.

Filming checklist

  • Vertical 9:16, steady phone, eye-level framing.
  • Natural light facing the speaker.
  • Clean audio (a small clip-on microphone helps).
  • Extra B-roll of hands, products and results.
  • Several takes of the hook.

Testing hooks

Post the same body with different openings over a week or two, or use platform features that test variations, and compare average watch time in the first seconds and completion rate. Keep a hook library of winners for future scripts.

Further reading

Edge cases and judgement calls

SituationWhat to do
No one on cameraHands-only, screen recordings, text-led or voice-over videos
Complex productsOne use case per video; series for depth
Regulated claimsApproved wording only; add required disclaimers
Repurposing long videosPick moments with a clear hook and payoff; reframe with on-screen text
Creator briefsGive the idea, key message and must-avoid list; let creators use their style
  • TikTok: tiktok-organic
  • Instagram: instagram-organic
  • YouTube Shorts and long form: youtube-seo-growth
  • LinkedIn video: linkedin-organic
  • Creators: creator-employee-advocacy
  • Paid creative: the Performance Marketing ad-creative-testing skill

Worked example

A project management app made 60-second product videos that opened with its logo and a list of features; most viewers left within two seconds. New scripts opened with relatable situations ("POV: three clients emailed asking for updates at once"), showed one feature solving one problem in under 25 seconds, used on-screen text throughout and ended with "follow for one project tip a week". Average watch time and completion rates rose sharply, and two videos became the account's best-performing content.

Output format

# Short video script: <idea>, <date>
## One-sentence idea and target viewer
## Hook options (top two marked)
## Beat sheet (time, visual, text, voice)
## Caption and keywords
## Call to action
## Variations to test

Common mistakes

  • Opening with a logo or introduction.
  • Several messages in one video.
  • No on-screen text.
  • Slow pacing.
  • Endings with no clear action.

Questions to ask before you script

  • What single idea should viewers remember?
  • What would make someone stop scrolling?
  • What can be shown, not just said?

Self-check before you answer

  • Does the first two seconds earn attention?
  • Is there one idea and one call to action?
  • Are visuals and on-screen text planned beat by beat?
  • Are hook variations ready to test?

When to use this skill, and when not to

Use it for organic short video on any platform, creator briefs, product demos, explainers, recruitment videos and turning long content into clips.

Short video rewards one thing: holding attention. Most brand videos fail because they open with a logo, explain context nobody asked for, cram several messages in or end without a reason to act. A good script fixes this before anyone picks up a camera.

Don’t use it for paid creative testing (use the Performance Marketing Ad Creative Testing skill) or long-form YouTube videos (use YouTube SEO).

Example prompts

  • “Script a 30-second product demo.”
  • “Write ten hooks for this video idea.”
  • “Turn this webinar into five short clips.”
  • “Write a creator brief for a Reels campaign.”
  • “Why do viewers leave our videos after two seconds?”

Example output

The skill returns a fixed structure. A shortened example for an imaginary site:

# Short video script: example project management app, 11 October 2026

Hook (0-2s): 'POV: three clients emailed asking for updates at once'
Value (2-22s): one feature solves one problem, on-screen text throughout
Payoff (22-27s): calm inbox, project dashboard
CTA (27-30s): 'Follow for one project tip a week'
Variations: two alternative hooks

Every script is planned beat by beat, with visuals and on-screen text, so the message works with sound on or off.

What the agent needs from you

The skill asks for the idea, product or message, platform and target viewer, length and format constraints, who appears and what locations or props are available, brand voice and claims rules and examples of videos the brand likes.

How this skill hands off to related skills

Scripts feed the set: TikTok, Instagram, YouTube, LinkedIn and Creators, plus paid creative with the Performance Marketing Ad Creative Testing skill.

How to run Short Video Scripts step by step

  1. Install the skill as short-video-scripts/SKILL.md.
  2. Write the idea in one sentence.
  3. Write ten hooks and pick two.
  4. Choose a structure and write the beat sheet.
  5. Cut ruthlessly and add on-screen text.
  6. Prepare variations to test.

Situations this skill handles

Video needs vary. The skill handles these situations:

SituationWhat the skill does
No one on cameraHands, screen recordings, text-led
Complex productsOne use case per video
Regulated claimsApproved wording and disclaimers
Repurposing long videosClips with a clear hook and payoff
Creator briefsIdea and must-haves, creator style
Low watch timeHook and pacing fixes

What makes this skill different

Most brand videos are written like ads. This skill writes for the scroll: hook first, one idea, a visual change every few seconds, on-screen text for sound off and a single clear action.

It produces hook variations ready to test, so every video teaches the team what holds attention.

Practical tips from real projects

  • One video, one idea.
  • Hook first, context later.
  • Show, do not just tell.
  • Earn the ending.

A worked example: a project management app made 60-second product videos that opened with its logo and a list of features; most viewers left within two seconds. New scripts opened with relatable situations, such as three clients emailing for updates at once, showed one feature solving one problem in under 25 seconds, used on-screen text throughout and ended with an invitation to follow for one project tip a week. Average watch time and completion rates rose sharply, and two videos became the best-performing content on the account.

Structures match the idea. Hook, steps and result suits tutorials. Problem, agitate and solve suits product demos. Before and after suits transformations, showing the end first. Myth, truth and proof suits education. A story arc of situation, tension, turning point and lesson suits founder and customer stories. Lists of three suit tips. Replying to a comment suits community questions.

The script template records the idea, target viewer and platform, length and a beat sheet with time, visual, on-screen text and voice-over for every few seconds, plus the caption with keywords, sound notes and call to action. A 30-second trainer-cleaning tutorial, for example, opens on the clean result with the promise on screen, runs three quick steps and ends with a prompt to save it for later.

The hook bank covers result first, mistakes, questions, bold claims, relatable situations and curiosity, with ten options written before choosing the strongest two.

Pacing changes with length: 15 seconds holds a hook, one point and a payoff; 30 seconds holds a hook, two or three steps, a payoff and a call to action; 60 seconds holds a story or several steps; 90 seconds only works when the story holds attention throughout. Visuals change every two to four seconds.

On-screen text is large, high-contrast and placed away from platform buttons, shown one short line at a time and kept on screen long enough to read.

Filming uses vertical framing at eye level, natural light facing the speaker, clean audio, extra B-roll of hands, products and results and several takes of the hook.

Hook testing posts the same body with different openings over a week or two, or uses platform features that test variations, then compares average watch time in the first seconds and completion rate, keeping a library of winning hooks for future scripts. When nobody wants to appear on camera, hands-only shots, screen recordings, text-led videos and voice-over work well. Complex products get one use case per video, with series for depth. Regulated products use approved wording and required disclaimers. Repurposed clips from long videos pick moments with a clear hook and payoff and reframe them with on-screen text. Creator briefs give the idea, key message and must-avoid list, then let creators use their own style, because audiences trust the creator voice more than a brand script.

Frequently asked questions

Fifteen seconds for single tips, 30 for tutorials and demos, 60 for stories, and 90 only if the story holds attention throughout.

Opening with the result, a mistake, a question, a bold claim or a relatable situation in the first two seconds.

Yes. On-screen text and captions carry the message for viewers watching with sound off.

Every two to four seconds, with a new angle, close-up, text card or B-roll.

One action only, such as save, follow, comment, send or visit.

Post the same body with different openings and compare early watch time and completion.

Changelog

  • 1.0.0, 10 October 2026: first release.

Use, adapt and share this skill under CC BY 4.0: credit Afeez Adebayo and link to this page.