Index of every page on this site: llms.txt
All skills
Run it yourself

Write YouTube Shorts (up to 60 seconds) and long-form video scripts that hold attention: an immediate hook, visible proof early, purposeful pacing, retention checkpoints, and honest AI-assisted production. Includes a shot-by-shot timing table, a retention-review checklist, a caption spec for 1080x1920, a full worked Shorts script, and a full worked long-form script. Use when scripting any Short, outlining a long-form video, or reviewing a script for drop-off points.

  • 7 files
  • 2.9 MB
  • Updated 5 days ago
  • GitHub
Use this Skill: https://skilld.dev/gh/jokerhtml/needcraft-skills/video-script-retention

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

README.md

≈549 tokens on demand. Your agent reads this file only when SKILL.md points to it.

Video Script & Retention

Write YouTube Shorts and long-form scripts that hold attention — hook first, proof early, one idea per beat, an honest limitation, one call to action.

What it is

A complete scripting method: Shorts structure (hook → proof → steps → caveat → CTA), a shot-by-shot timing table, a retention-review checklist, a caption spec for 1080×1920, a full worked 60-second Shorts script, a full worked 10-minute long-form script, and YouTube discovery + AI-disclosure rules verified 16 November 2026.

Who it is for

Creators and small teams scripting their own videos who want a repeatable structure instead of a blank page each time.

How to use

  1. State the video's single promise in one sentence.
  2. Draft from the structure in SKILL.md — Shorts or long-form.
  3. Run the retention-review checklist and the read-aloud test before recording.
  4. Check the disclosure rules before uploading any AI-assisted video.

Example

The worked 60-second script in SKILL.md (147 words, ~59 seconds) and the worked 10-minute long-form script are both complete and ready to adapt. A plain-text copy of the Shorts script is in examples/shorts-script-houseplants.md.

Install

This is a skill (a SKILL.md playbook), not software. Copy the video-script-retention/ folder into your agent's skills directory and invoke it when scripting a video, or follow it manually as a checklist.

License

MIT — see LICENSE in the repository root, or treat this file set as MIT-licensed.

Disclaimer

Duration estimates are rough (±15% around 150 wpm) — the read-aloud test is the measurement. Analytics bands are practitioner guidance, not YouTube-published thresholds. Discovery and disclosure rules are dated 16 November 2026; re-check YouTube's help pages before relying on them.

Example images — real output

Three storyboard frames from NeedCraft reel-01 (product intro), showing the retention structure in order — hook, problem, CTA (1080×1920).

Hook — AI can write your email in 30 seconds

Problem beat

CTA beat

Source: SKILL.md on GitHub

No rule matched.

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

No third-party reports yet.

Signed by skilld at 90f40b1. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 4 days ago.

Activeupdated 5 days ago
Other metadata
metadata
{
  "version": "1.0.0",
  "date": "2026-11-16",
  "author": "Muhammad Saad Ranjha / NeedCraft"
}

README badge

README badge for jokerhtml/needcraft-skills/video-script-retention