| name | social-new-video |
| description | One-shot launcher for a new Italian YouTube video. Spawns a single codex|claude tab (via iso-spawn) that runs the full chain inside itself — social-new-notebooklm-project (research → you pick the title) then social-notebooklm-artifacts (scaletta + 4 infographics). Fire-and-focus: async spawn with --focus, no kill; you own the tab. Use when invoked as /social-new-video <topic | youtube-url...> [--agent codex|claude] [--bounded] [--script-only | --images-only] [extra-source ...], or asked to spin up a whole new video (notebook + assets) in one go. Default agent codex. Pairs with social-new-notebooklm-project and social-notebooklm-artifacts (which it chains). Requires the iso-spawn skill + a herdr workspace. |
social-new-video
The single entry point for a new video. It does not do the work itself — it spawns one agent tab that runs the whole chain end-to-end, and focuses you into that tab so you can pick the title. The chain is:
social-new-video (this skill — the launcher, runs where you invoke it)
└─ iso-spawn → new codex|claude tab, runs:
1. social-new-notebooklm-project <topic|url...> research → 6 Italian titles → YOU PICK → notebook + sources
2. social-notebooklm-artifacts scaletta (long+short) + 4 infographics, from that notebook
Why a spawned tab? The notebook step is research-heavy (codex's deep-research path is the native fit) and the whole chain is long + quota-paced. Isolating it in its own tab keeps your launching session clean. Topology: everything runs in the spawned tab; you drive the interactive title pick there. The launcher is fire-and-focus — it spawns async with --focus and does not kill or babysit the tab. You own its lifecycle afterward.
Input
Invoked as /social-new-video <topic | youtube-url...> [--agent codex|claude] [--bounded] [--script-only | --images-only] [extra-source ...].
<topic | youtube-url...> — required. A text topic or one/more YouTube URLs. Forwarded verbatim to social-new-notebooklm-project (topic mode vs video-seed mode is decided there).--agent codex|claude — optional. Which agent the spawned tab runs. Default codex (matches the notebook skill's Codex-agent deep-research default).--bounded — optional. Smaller research pass. Forwarded to social-new-notebooklm-project.--script-only / --images-only — optional, mutually exclusive. Restrict the artifact step. Forwarded to social-notebooklm-artifacts. Default (neither): scaletta + 4 infographics.[extra-source ...] — optional, zero or more files/URLs. Forwarded as extra sources for the notebook.
If no topic/URL is given, halt: social-new-video: topic or YouTube URL required.
Pre-flight
- The iso-spawn skill must be installed (the launcher locates its
scripts/spawn.sh).
- You must be inside a herdr workspace (iso-spawn resolves the tab from
$HERDR_PANE_ID).
- The spawned agent needs the two chained skills + the
notebooklm CLI (authenticated) available — they run inside the tab, so their own pre-flights apply there, not here. The launcher itself only needs to find spawn.sh.
Run
cd skills/social-new-video
scripts/run.sh <topic | youtube-url...> [--agent codex|claude] [--bounded] [--script-only|--images-only] [extra-source ...]
run.sh:
- Parses args — splits its own knobs (
--agent, --script-only/--images-only) from what is forwarded to the notebook skill (topic/URLs, --bounded, extra-sources).
- Locates
iso-spawn/scripts/spawn.sh (sibling skill dir, then ~/.claude/skills, then ~/.codex/skills).
- Builds an Italian chained prompt instructing the spawned agent to run skill 1 → stop for the title pick → run skill 2 on the now-active notebook.
- Spawns the tab async with
--focus (no --kill): spawn.sh <agent> --prompt "<chain>" --focus. stdout is the TERM handle.
After it returns: switch to the focused tab, pick your title when the 6 options appear, and let the chain finish (research adds sources, then the artifacts step writes the scaletta + the 4 PNGs to <base>/<YYYY-MM-DD>-<title>/). The infographics are quota-paced (budget-capped at 4) — see social-notebooklm-artifacts for the knobs.
Lifecycle (you own the tab)
The launcher exits right after spawning; it never polls or kills. When the chain is done and you've collected the assets, tear the tab down yourself with iso-spawn:
<iso-spawn>/scripts/spawn.sh cleanup "<TERM>" --kill
<iso-spawn>/scripts/spawn.sh cleanup --orphaned
Known failure modes (learned)
| Symptom | Cause | Handling |
|---|
could not find iso-spawn/scripts/spawn.sh | iso-spawn skill not installed | install the engineering plugin / run node scripts/install.js so iso-spawn is symlinked |
| spawn does nothing / no tab | not inside a herdr workspace | run from a herdr pane (iso-spawn needs $HERDR_PANE_ID) |
| title prompt never answered, chain stalls | you didn't switch to the spawned tab | the pick is interactive in the tab; --focus jumps you there — answer with a number 1–6 |
| agent skipped the title pick / auto-chose | prompt not followed | the injected prompt says "NON saltare la scelta del titolo"; if an agent still rushes, send it social-new-notebooklm-project again or pick manually |
| images didn't generate | NotebookLM daily quota (~8/rolling-24h) | the artifacts step stops cleanly and lists ungenerated quadrants; rerun social-notebooklm-artifacts --images-only next day |
| tab left running after you're done | launcher never kills (by design) | tear down manually with iso-spawn cleanup --kill / cleanup --orphaned |
