auto-video-gen: Skill for Claude Code

Create News Video Skill

Generate a Vietnamese 9:16 motion-graphic news video from a URL or .txt file.

Input

Single argument: a news article URL (starts with http:// or https://) OR a path to a .txt file.

Workflow (MUST follow these steps in order)

Step 1: Detect input type

• Starts with http:// or https:// → URL mode
• Otherwise → file mode

Step 2: Fetch content

URL mode:

• Use read_url_content (or browser_subagent if the page is dynamic / JS-rendered).
• Extract:
  • title (string): tiêu đề bài báo
  • content (string): nội dung chính, ~500-1500 từ
  • ogImage (string|null): URL ảnh og:image (meta og:image hoặc ảnh đầu bài)
  • domain (string): domain của URL (vd "vnexpress.net")
• If fetching fails (paywall, blocking, 4xx) → tell user to save content to a .txt file and pass that instead. Stop.

File mode:

• Use view_file to read the .txt file.
• Title = first non-empty line (strip whitespace, max 80 chars)
• Content = remaining lines joined
• ogImage = null
• domain = "local"

Step 3: Create slug + output directory

• slug = lowercase ASCII (strip Vietnamese diacritics, đ→d), replace non-alphanumeric with -, trim dashes, max 40 chars
• timestamp = current local time as YYYYMMDD-HHmm
• outputDir = output/<slug>-<timestamp>/

Step 4: Generate script.json

Following the schema in docs/superpowers/specs/2026-04-29-auto-news-video-design.md Section 4. Key rules:

Script content (Vietnamese):

• Total voiceText: ~150–200 words → ~55–65s spoken at speed 1.0
• Number of scenes: 5–8 (1 hook + 3–6 body + 1 outro)
• Each scene voiceText is 1-3 short sentences, văn nói (spoken style, not formal)
• No emoji, no markdown in voiceText

⚠️ CRITICAL: Vietnamese TTS Phonetic Rules

The voiceText field is read aloud by Edge TTS / LucyLab / ElevenLabs / Vbee. Numbers and symbols are read literally — if you write "5.5", TTS may say "năm rưỡi" (five and a half — WRONG for version numbers). Always spell out numbers in Vietnamese phonetic form in voiceText. The templateData fields (visual text on screen) can keep the original "5.5" / "82.7%" formatting.