Skip to content

puntorigen/avatar-skills / viral-video-script

viral-video-script

Verified

Write 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.

FileKindSize
REFERENCE.mdmarkdown6.6 KB
SKILL.mdskill md8.7 KB
examples.mdmarkdown5.9 KB
scripts/check_script.pyexecutablescript5.6 KB
scripts/render_script.pyexecutablescript3.7 KB
scripts/scaffold.pyexecutablescript3.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())
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