puntorigen/avatar-skills / viral-video-script
viral-video-script
VerifiedWrite short-form video scripts / dialogue that follow Tuan Le's "3 billion views" viral formula — the six psychological principles (familiarity / format-steal, curiosity-gap hook, identity over product via the Means-End Chain, the credential / authority shortcut, built-in shareability, and the Hook→Problem→Story→Payoff story skeleton with fast cuts + captions). Produces a beat sheet (JSON), a shooting script (Markdown) and a clean narration track (txt) ready to feed voice-clone / avatar-reel-composer. Use when the user wants to write a script, dialogue, hook, or voice-over for a reel / short / TikTok, make a brand or product go viral, repurpose a boring product into engaging content, or mentions "guion", "guión", "script para un reel", "diálogo", "hook viral", "voz en off", or the viral / psychology content formula.
| File | Kind | Size |
|---|---|---|
| REFERENCE.md | markdown | 6.6 KB |
| SKILL.md | skill md | 8.7 KB |
| examples.md | markdown | 5.9 KB |
| scripts/check_script.pyexecutable | script | 5.6 KB |
| scripts/render_script.pyexecutable | script | 3.7 KB |
| scripts/scaffold.pyexecutable | script | 3.9 KB |
scripts/scaffold.py
View on GitHub#!/usr/bin/env python3
"""Scaffold a viral-video-script beat sheet (JSON) pre-structured with the formula.
Creates <out>/<slug>.script.json with every field the formula needs and the
Hook -> Problem -> Story -> Payoff beats, each carrying a "TODO:" placeholder for
the agent to replace. Pure stdlib, no install needed.
python3 scaffold.py buldak-spicy --product "Buldak instant ramen" \
--language en --platform tiktok --seconds 32 --out scripts_out/
"""
from __future__ import annotations
import argparse
import json
import sys
from pathlib import Path
# Rough beat budget as a fraction of total seconds (Hook/Problem/Story/Payoff).
BEAT_SPLIT = {"hook": 0.07, "problem": 0.18, "story": 0.60, "payoff": 0.15}
BEAT_NOTE = {
"hook": "Curiosity gap + credential. NO product name. Use the stolen format's opener.",
"problem": "The tension the viewer already feels, framed at the IDENTITY layer.",
"story": "The recognizable format plays out; product enters naturally, never as a pitch.",
"payoff": "Resolve the gap + identity reward, then the lightest possible product/CTA.",
}
def build_template(slug: str, product: str, language: str, platform: str, seconds: int) -> dict:
beats = []
for name in ("hook", "problem", "story", "payoff"):
beats.append(
{
"beat": name,
"seconds": max(1, round(seconds * BEAT_SPLIT[name])),
"spoken": f"TODO: spoken copy for the {name}",
"on_screen": f"TODO: on-screen action for the {name}",
"caption": f"TODO: burned-in caption text for the {name}",
"note": BEAT_NOTE[name],
}
)
return {
"slug": slug,
"language": language,
"platform": platform,
"target_seconds": seconds,
"subject": {
"product": product,
"audience": "TODO: who is watching (drives identity layer + tone)",
"format_steal": "TODO: a proven format to steal (reaction / challenge / office tour / 'hey chef ...')",
"credential": "TODO: the authority shown in the first 2s (e.g. 'Korean street-food chef')",
"identity_value": "TODO: layer-3 value — what watching/owning this MEANS about the viewer",
"share_trigger": "surprise",
"shareable_premise": "TODO: the whole video in ONE sentence a friend could repeat",
},
"captions": True,
"cut_every_seconds": 3,
"beats": beats,
}
def main() -> int:
ap = argparse.ArgumentParser(description="Scaffold a viral-video-script beat sheet JSON.")
ap.add_argument("slug", help="Short kebab-case id, e.g. buldak-spicy")
ap.add_argument("--product", required=True, help="Product / brand / topic")
ap.add_argument("--language", default="en", help="Spoken language code (default: en)")
ap.add_argument(
"--platform",
default="tiktok",
choices=["tiktok", "reels", "shorts"],
help="Target platform (default: tiktok)",
)
ap.add_argument("--seconds", type=int, default=32, help="Target length in seconds (default: 32)")
ap.add_argument("--out", type=Path, default=Path("."), help="Output directory (default: .)")
ap.add_argument("--force", action="store_true", help="Overwrite if the file already exists")
args = ap.parse_args()
args.out.mkdir(parents=True, exist_ok=True)
dest = args.out / f"{args.slug}.script.json"
if dest.exists() and not args.force:
print(f"ERROR: {dest} already exists (use --force to overwrite)", file=sys.stderr)
return 1
data = build_template(args.slug, args.product, args.language, args.platform, args.seconds)
dest.write_text(json.dumps(data, ensure_ascii=False, indent=2) + "\n", encoding="utf-8")
print(f" -> {dest}")
print(" Fill every TODO, then validate with check_script.py.")
return 0
if __name__ == "__main__":
raise SystemExit(main())
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| 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: 196k | Updated | Claude CodeCodex | Verified | Install |