---
name: new-video
description: Scaffold the next video project, pick/confirm an idea from content/ideas.md, create content/videos/NNN-slug/ with brief, recording guide, titles, description draft, and thumbnail drafts. Use when the creator says "new video", "next video", or names an idea to produce.
---
<!-- Adapted from the hijoseromero production repo (Claude Code skill). Generic version: personal rules, private paths and names removed.
   Assumes a repo laid out as content/videos/NNN-slug/, content/ideas.md, pipeline/, tools/ (auto-editor, faster-whisper, Playwright).
   Drop this file at.claude/skills/new-video/SKILL.md and invoke with /new-video. -->

# New video scaffold

1. Determine NNN: next number after the highest in `content/videos/`. Slug: short-kebab from the working title.
2. If the creator didn't name an idea: show the 3 most relevant unused ideas from `content/ideas.md` and let them pick. Mark the chosen idea `[NNN]` in ideas.md.
3. **Packaging FIRST** (audit-backed rule, NetworkChuck/Geerling): draft `titles.md` (20 candidates + **3 picks: A/B/C, one per thumbnail**) and the thumbnail concept BEFORE locking the outline. If no title excites, the idea isn't ready, send it back to `/ideas`.
4. **Beat map before script**: write `beats.md` per `pipeline/script-craft.md`, loops opened/closed, mini-hooks, slide IDs. Script and slides both generate from it.
5. Create `content/videos/NNN-slug/` containing:
  - `brief.md`, from `content/templates/video-brief.md`, filled: verbatim hook, ≤5 outline bullets, ONE CTA, thumbnail concept. Voice per `brand/identity.md`.
  - `research.md`, facts/numbers/sources for every claim. Firsthand where possible; WebSearch only for external claims. Include an "honesty guardrails" section (what not to oversell + privacy no-gos for THIS video).
  - `recording-guide.md`, section-by-section talking points with 🎯 NAIL THIS markers; hook verbatim; per-section screen directions; the ⚠️ screen-privacy shot-list (copy pattern from 001).
  - `titles.md`, 20 candidates in a table (chars + formula per `content/templates/metadata.md`), then **3 picks (A/B/C) with reasoning, each paired to one of the 3 thumbnail drafts** (standing rule 2026-07-25: always 3 titles × 3 thumbnails, like 002/003's A/B test setup).
  - `description.md`, filled metadata template, timestamps as 0X:XX placeholders.
  - `talking-points.html`, the ON-SCREEN prep sheet the creator actually reads while recording. Template/style reference: a previous video's `talking-points.html` (dark `#1a1a1a`, orange headings, TAB chips, blockquoted source quotes, bridge lines, tab-order links at bottom, "never on the recorded screen" warning). Content mirrors cheatsheet/recording-guide, keep them in sync.
  - `thumbnail/`, 3 drafts at 1280×720 via ImageMagick: `#1A1A1A` bg, circular face cutout right third (from your face cutout), ≤4 words in `#F0A45E`/white (Liberation-Sans-Bold), signature-orange logo bottom-left. Reuse the magick recipe from 001's git history.
6. Then `/slides` generates the deck from the same `beats.md`; add a newsletter CTA line to the script (every video carries it, see brand audit).
7. Full draft transcript (`transcript.md`) only if the creator asks, the house rule is outline > script.
8. Hard rules: read your privacy rules file first; pressure-test the hook (would YOU keep watching?); ≤5 outline bullets/beats, no exceptions.
