arca-marketing-video 2.4.0 → 2.6.0

package/README.md

@@ -1,32 +1,41 @@
 # arca-marketing-video
 
-A brand-driven short-form marketing content kit, packaged as **four individual agent skills**
-that share one editable brand profile and asset set. Use any skill on its own, or chain them.
+A brand-driven short-form marketing kit: **four installable Claude Code skills** that share one
+editable brand profile and asset set. Use any skill on its own, or chain them.
+
+## Install (into Claude Code)
 
 ```
-npm install arca-marketing-video
+npx arca-marketing-video            # installs into ./.claude/skills (this project)
+npx arca-marketing-video --global   # installs into ~/.claude/skills (all projects)
 ```
 
-## The four skills (`skills/`)
+That copies the four skills into your `.claude/skills/` so Claude Code auto-discovers them.
+(If `.claude/skills/` didn't exist before, restart Claude Code once so it starts watching it.)
+
+> `npm install arca-marketing-video` alone does **not** register the skills — Claude Code only
+> scans `.claude/skills/`, not `node_modules/`. Run the `npx` command above.
+
+## The four skills
 
 | Skill | Use when you want to… |
 | --- | --- |
-| `skills/carousel-generator` | Make a 3–5 slide Instagram carousel (4:5) — slide copy + per-slide image-gen prompts + caption |
-| `skills/storyboard-prompt` | Pressure-test a video idea and turn it into a phone-native 3×3 (9-panel) storyboard |
-| `skills/video-prompt` | Turn a 3×3 storyboard into realistic vertical UGC video (drives the Wyren MCP; keeps faces consistent) |
-| `skills/shorts-editor` | Cut / caption / add graphics to existing footage → a high-retention short (HyperFrames + ffmpeg + faster-whisper) |
+| `carousel-generator` | Make a 3–5 slide Instagram carousel (4:5) |
+| `storyboard-prompt` | Pressure-test a video idea → a clean frames-only 3×3 grid + a text breakdown |
+| `video-prompt` | Turn a storyboard into vertical video (drives the Wyren MCP; rebuilds schematic boards with Wyren clips + HyperFrames graphics) |
+| `shorts-editor` | Cut / caption / add graphics to existing footage → a high-retention short |
 
-Each folder has its own `SKILL.md` with YAML frontmatter (`name` + `description`). The shorts
-editor also ships `silence_cut.py` and `composition.template.html`.
+After installing, each appears as a skill (e.g. `/carousel-generator`).
 
 ## Shared brand profile + assets
 
-Every skill reads brand specifics from one place, so the kit is reusable for any brand:
+All four skills read brand specifics from one place, so the kit is reusable for any brand:
 
-- `brand.md` — the brand profile (name, tone, audience, colors, persona, visual world, logo rules)
-- `assets/` — `logo.png`, `characters.png`, `design-guide.png`, `final-cta.png`
+- `_arca-marketing-assets/brand.md` — the brand profile
+- `_arca-marketing-assets/assets/` — `logo.png`, `characters.png`, `design-guide.png`, `final-cta.png`
 
-Skills reference these via `../../brand.md` and `../../assets/`.
+This `_arca-marketing-assets/` folder has no `SKILL.md`, so Claude Code ignores it as a skill; the
+skills reference it via `../_arca-marketing-assets/…`. To retarget to another brand, swap those files.
 
 ## Natural chain
 
@@ -35,11 +44,6 @@ storyboard-prompt  →  video-prompt  →  shorts-editor      (original video)
 carousel-generator                                        (independent)
 ```
 
-## Retarget to another brand
-
-Replace `brand.md` with your own profile (keep the field structure) and swap the files in
-`assets/`. No skill edits needed.
-
 ## License
 
 MIT

package/bin/cli.js

@@ -0,0 +1,67 @@
+#!/usr/bin/env node
+'use strict';
+
+// Installs the four Arca marketing skills into a Claude Code skills directory.
+//   npx arca-marketing-video            -> ./.claude/skills (this project)
+//   npx arca-marketing-video --global   -> ~/.claude/skills (all projects)
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+const args = process.argv.slice(2);
+
+if (args.includes('-h') || args.includes('--help')) {
+  process.stdout.write(`
+arca-marketing-video — install the marketing skills into Claude Code
+
+Usage:
+  npx arca-marketing-video            Install into ./.claude/skills (this project)
+  npx arca-marketing-video --global   Install into ~/.claude/skills (all projects)
+  npx arca-marketing-video --help     Show this help
+
+Installs: carousel-generator, storyboard-prompt, video-prompt, shorts-editor
+(plus a shared brand profile + assets the skills read).
+`);
+  process.exit(0);
+}
+
+const isGlobal = args.includes('--global') || args.includes('-g');
+const baseDir = isGlobal ? os.homedir() : process.cwd();
+const skillsRoot = path.join(baseDir, '.claude', 'skills');
+const srcSkills = path.join(__dirname, '..', 'skills');
+
+if (typeof fs.cpSync !== 'function') {
+  process.stderr.write('Error: Node 16.7+ is required (fs.cpSync). Please upgrade Node.\n');
+  process.exit(1);
+}
+
+const skillsRootExisted = fs.existsSync(skillsRoot);
+fs.mkdirSync(skillsRoot, { recursive: true });
+
+const entries = fs
+  .readdirSync(srcSkills, { withFileTypes: true })
+  .filter((d) => d.isDirectory());
+
+const installedSkills = [];
+for (const dir of entries) {
+  const from = path.join(srcSkills, dir.name);
+  const to = path.join(skillsRoot, dir.name);
+  fs.rmSync(to, { recursive: true, force: true });
+  fs.cpSync(from, to, { recursive: true });
+  if (!dir.name.startsWith('_')) installedSkills.push(dir.name);
+}
+
+process.stdout.write(`\n✓ Installed ${installedSkills.length} Arca marketing skills into ${skillsRoot}\n`);
+for (const name of installedSkills.sort()) process.stdout.write(`  • ${name}\n`);
+process.stdout.write(`  (+ shared brand profile & assets in _arca-marketing-assets)\n`);
+
+if (!skillsRootExisted) {
+  process.stdout.write(
+    `\nNote: .claude/skills was just created — restart Claude Code once so it starts watching the folder.\n\n`
+  );
+} else {
+  process.stdout.write(
+    `\nThe skills are available now — Claude Code detects skill changes live.\n\n`
+  );
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "arca-marketing-video",
-  "version": "2.4.0",
-  "description": "Brand-driven short-form marketing content kit: four individual agent skills (carousel generator, storyboard prompt, video prompt, shorts editor) plus a shared brand profile and assets.",
+  "version": "2.6.0",
+  "description": "Brand-driven short-form marketing content kit: four installable Claude Code skills (carousel generator, storyboard prompt, video prompt, shorts editor) plus a shared brand profile and assets. Run `npx arca-marketing-video` to install them into .claude/skills.",
   "keywords": [
     "skill",
     "claude",
@@ -18,10 +18,15 @@
   ],
   "author": "aobalitaan",
   "license": "MIT",
+  "bin": {
+    "arca-marketing-video": "bin/cli.js"
+  },
+  "engines": {
+    "node": ">=16.7"
+  },
   "files": [
+    "bin/",
     "skills/",
-    "brand.md",
-    "assets/",
     "README.md",
     "LICENSE"
   ]

package/skills/carousel-generator/SKILL.md

@@ -6,7 +6,7 @@ description: Use when creating an Instagram (or LinkedIn) image carousel of 3–
 # Carousel Generator
 
 ## Brand profile (read first)
-Read `../../brand.md` first and apply it throughout: name-usage rules, tone, audience, positioning, color palette, persona, visual world, recurring objects, and logo rules. Brand assets live in `../../assets/` (`logo.png`, `characters.png`, `design-guide.png`, `final-cta.png`). Use the supplied logo only — never invent or distort it. Swap `../../brand.md` + `../../assets/` to retarget this skill to another brand.
+Read `../_arca-marketing-assets/brand.md` first and apply it throughout: name-usage rules, tone, audience, positioning, color palette, persona, visual world, recurring objects, and logo rules. Brand assets live in `../_arca-marketing-assets/assets/` (`logo.png`, `characters.png`, `design-guide.png`, `final-cta.png`). Use the supplied logo only — never invent or distort it. Swap `../_arca-marketing-assets/brand.md` + `../_arca-marketing-assets/assets/` to retarget this skill to another brand.
 
 ---
 
@@ -18,15 +18,15 @@ INTAKE — ASK FIRST:
 Before writing anything, ask the user for the inputs you need, then wait for their answers:
 1. TOPIC / CONCEPT — the vague idea or angle for this carousel.
 2. TARGET MARKET / AUDIENCE — who this is for and what they struggle with.
-3. BRAND PROFILE — the attached or pasted ../../brand.md (brand name, positioning, tone, visual world, colors, persona, recurring objects, hook/CTA examples).
+3. BRAND PROFILE — the attached or pasted ../_arca-marketing-assets/brand.md (brand name, positioning, tone, visual world, colors, persona, recurring objects, hook/CTA examples).
 If the user leaves something blank, make smart assumptions and state them briefly. Do not stall unless the topic is impossible to understand.
 
 INPUTS / VARIABLES TO FILL IN:
-- BRAND PROFILE: [attach or paste ../../brand.md]
+- BRAND PROFILE: [attach or paste ../_arca-marketing-assets/brand.md]
 - TOPIC: [the vague topic or concept]
 - TARGET MARKET: [the audience this carousel targets]
 
-All brand specifics — brand name and how to write it, audience, positioning, core idea, tone, visual world, color palette, persona, and recurring objects — come from the attached BRAND PROFILE (../../brand.md). Read it first and apply it throughout. Do not hardcode any single brand’s details into this template.
+All brand specifics — brand name and how to write it, audience, positioning, core idea, tone, visual world, color palette, persona, and recurring objects — come from the attached BRAND PROFILE (../_arca-marketing-assets/brand.md). Read it first and apply it throughout. Do not hardcode any single brand’s details into this template.
 
 BRAND, AUDIENCE, POSITIONING, AND TONE:
 See the attached BRAND PROFILE. Follow its name-usage rules, target audience, positioning, "should feel like / should not feel like" guidance, and tone exactly.

package/skills/shorts-editor/SKILL.md

@@ -12,8 +12,8 @@ on-screen graphics / zooms / SFX layered in, or a brand splash / end card.
 Built on HyperFrames + ffmpeg + faster-whisper.
 
 ## Brand profile (read first)
-Read `../../brand.md` for the brand's colors, logo rules, and persona. The brand-splash end card
-uses `../../assets/final-cta.png`; the logo (`../../assets/logo.png`) may appear as a subtle
+Read `../_arca-marketing-assets/brand.md` for the brand's colors, logo rules, and persona. The brand-splash end card
+uses `../_arca-marketing-assets/assets/final-cta.png`; the logo (`../_arca-marketing-assets/assets/logo.png`) may appear as a subtle
 in-world mark. `silence_cut.py` and `composition.template.html` are co-located in this skill folder.
 This skill is the final edit stage after `video-prompt` (or runs standalone on any raw footage).
 
@@ -55,7 +55,7 @@ Neither signal alone works:
 - **Graphic chips:** glass pill + inline-SVG icon + short label, in the **lower-mid torso band (~y1170 of 1920)** — below the face, above the captions. "Over the people" is fine; over the face is not. One per beat, pop in / hold / pop out.
 - **Zoom punch-ins:** scale the plate wrapper (base ~1.04) to ~1.10-1.14 on emphasis lines, ease back. Never scale below 1.0 (reveals letterbox edges). Cover-fit the plate.
 - **SFX:** riser on the very first frame; soft whoosh on hard cuts / speaker changes; pop on each chip entrance. Keep dialogue front (SFX vol 0.25-0.35). Mixkit free SFX (`mixkit.co/free-sound-effects/<cat>/` → `assets.mixkit.co/.../<id>-preview.mp3`) is a reliable no-key source.
-- **Brand splash:** 3s end card (a still image — use `../../assets/final-cta.png`), brought in by a quick white flash + one signature SFX, with a subtle ken-burns zoom. Reserve that SFX for the splash only.
+- **Brand splash:** 3s end card (a still image — use `../_arca-marketing-assets/assets/final-cta.png`), brought in by a quick white flash + one signature SFX, with a subtle ken-burns zoom. Reserve that SFX for the splash only.
 
 ## Gotchas
 | Symptom | Fix |

package/skills/storyboard-prompt/SKILL.md

@@ -6,7 +6,7 @@ description: Use when pressure-testing a short-form video idea and turning it in
 # Storyboard Prompt
 
 ## Brand profile (read first)
-Read `../../brand.md` first and apply its name-usage rules, tone, audience, persona, logo rules, and colors throughout. Brand assets live in `../../assets/` (`logo.png`, `characters.png`, `design-guide.png`, `final-cta.png`). Use the supplied logo only — never invent or distort it. The natural next step after this skill is `video-prompt` (turn the storyboard into video). Swap `../../brand.md` + `../../assets/` to retarget to another brand.
+Read `../_arca-marketing-assets/brand.md` first and apply its name-usage rules, tone, audience, persona, logo rules, and colors throughout. Brand assets live in `../_arca-marketing-assets/assets/` (`logo.png`, `characters.png`, `design-guide.png`, `final-cta.png`). Use the supplied logo only — never invent or distort it. The natural next step after this skill is `video-prompt` (turn the storyboard into video). Swap `../_arca-marketing-assets/brand.md` + `../_arca-marketing-assets/assets/` to retarget to another brand.
 
 ---
 
@@ -25,7 +25,7 @@ Before doing anything, ask the user for the inputs you need, then wait for their
 1. RAW CONCEPT — the video idea to pressure-test and storyboard.
 2. VIDEO TYPE / STYLE — UGC / phone-shot (default), cinematic / movie-trailer, animation, motion-graphics, product film, skit, etc. This drives the LOOK and the first-5-seconds cold-open strategy.
 3. TARGET MARKET / AUDIENCE — who this is for.
-4. BRAND PROFILE — the attached or pasted ../../brand.md (brand name, positioning, tone, persona, logo rules, colors).
+4. BRAND PROFILE — the attached or pasted ../_arca-marketing-assets/brand.md (brand name, positioning, tone, persona, logo rules, colors).
 5. TARGET FORMAT — TikTok / Instagram Reels / YouTube Shorts.
 6. PREFERRED LENGTH — or let you recommend one.
 Ask first. Only make smart, briefly stated assumptions for whatever is still missing. Do not stall unless the concept is impossible to understand.
@@ -59,10 +59,10 @@ Raw concept:
 [PASTE THE CONCEPT HERE]
 
 Brand:
-[BRAND NAME — see the attached brand profile (../../brand.md)]
+[BRAND NAME — see the attached brand profile (../_arca-marketing-assets/brand.md)]
 
 Brand profile:
-[ATTACH OR PASTE ../../brand.md — positioning, tone, persona, logo rules, colors]
+[ATTACH OR PASTE ../_arca-marketing-assets/brand.md — positioning, tone, persona, logo rules, colors]
 
 Logo asset:
 Use the attached brand logo if available.
@@ -322,7 +322,7 @@ For each hook, provide:
 - how to make it more visual
 - whether it can be understood without sound
 - stickiness: is the line catchy, sharp, and quotable (a phrase the viewer could repeat)?
-- brand fit: does the message ladder to the brand's positioning, audience, and tone (per ../../brand.md)?
+- brand fit: does the message ladder to the brand's positioning, audience, and tone (per ../_arca-marketing-assets/brand.md)?
 
 Then score the hooks on three axes — scroll-stop power, stickiness, and brand fit — rank the top 3, and choose the single strongest hook (highest combined, never high scroll-stop but off-brand).
 
@@ -332,7 +332,7 @@ The chosen hook must be:
 - fast
 - emotionally clear
 - catchy and memorable — a line or image worth repeating, not just clear
-- on-brand — in the brand's voice and aligned to its message (see ../../brand.md), never generic
+- on-brand — in the brand's voice and aligned to its message (see ../_arca-marketing-assets/brand.md), never generic
 - a true promise that sets up the brand's value (not a clever line that goes nowhere)
 - easy to execute in the chosen video type
 - not corporate
@@ -414,13 +414,13 @@ Create an ending that naturally connects back to the first frame if possible.
 
 BRAND MESSAGING ALIGNMENT (non-negotiable)
 Pull the brand's positioning, core idea, tone, target audience, audience pain, and hook/CTA examples
-from ../../brand.md, and make the polished concept ladder to them:
+from ../_arca-marketing-assets/brand.md, and make the polished concept ladder to them:
 - The hook and core promise must speak to the brand's exact audience and the specific pain it solves —
   not a generic version of the topic.
 - The payoff must implicitly prove the brand's value (the transformation the brand enables), so the
   viewer connects the idea to what the brand does — without it feeling like an ad.
 - Tone must match the brand's voice: keep its do's and avoid its don'ts (no hype / buzzwords / cringe,
-  or whatever ../../brand.md specifies).
+  or whatever ../_arca-marketing-assets/brand.md specifies).
 - The CTA should echo the brand's CTA style and lead softly and naturally to the brand.
 - Treat the brand's hook/CTA examples as a springboard, not copy-paste — write a fresher, sharper line.
 State in ONE line how the chosen hook + payoff + CTA map to the brand's message.
@@ -700,7 +700,11 @@ The grid:
   edge-to-edge or with a thin uniform gutter, so every frame crops out cleanly on its own.
 - Frames in beat order (frame 1 = top-left). Each frame is a different moment (the 9 beats below).
 - Render the frames in the chosen VIDEO TYPE's look (UGC phone-shot by default — raw, imperfect,
-  human per Phases 6 and 9; cinematic / animation / product film per the declared type).
+  human per Phases 6 and 9; cinematic / animation / product film per the declared type). For UGC, the
+  frames must read like stills grabbed from a phone video, NOT stock/AI photos — apply Phases 6 & 9
+  (real skin texture, non-model casting, mixed practical light, off-center handheld framing, lived-in
+  clutter); avoid even studio light, model-perfect symmetric faces, plastic skin, and staged centering.
+  (`video-prompt` reuses these frames as start frames, so the realism has to start here.)
 
 The frames must contain NO:
 - panel numbers, labels, titles, or letters

package/skills/video-prompt/SKILL.md

@@ -1,12 +1,12 @@
 ---
 name: video-prompt
-description: Use when turning a storyboard into a finished vertical short-form video of any type (UGC, cinematic / movie-trailer, animation, product film, etc.). Handles both photographic storyboards (clean and use as start frames) and schematic / annotated plans (do NOT upscale 1:1 — rebuild patterned to them using Wyren clips for live footage + HyperFrames for on-screen graphics). Drives the Wyren MCP — picks image/video models and resolutions, optimizes the TikTok first 5 seconds, and keeps character faces consistent across shots. Triggers on "make the video from this storyboard", "generate the short", "render the clips". Part of the arca-marketing-video kit.
+description: Use when turning a storyboard into a finished vertical short-form video of any type (UGC, cinematic / movie-trailer, animation, product film, etc.). Handles both photographic storyboards (clean and use as start frames) and schematic / annotated plans (do NOT upscale 1:1 — rebuild patterned to them using Wyren clips for live footage + HyperFrames for on-screen graphics). Drives the Wyren MCP — picks image/video models and resolutions, forces phone-camera realism on the start frames (so they don't look like stock/AI photos), generates multi-angle coverage so the edit can cut fast like real UGC, optimizes the TikTok first 5 seconds, and keeps character faces consistent across shots. Triggers on "make the video from this storyboard", "generate the short", "render the clips". Part of the arca-marketing-video kit.
 ---
 
 # Video Prompt
 
 ## Brand profile (read first)
-Read `../../brand.md` first and apply its name-usage, persona, logo rules, and colors. Brand assets live in `../../assets/` — feed `../../assets/characters.png` (persona) and `../../assets/logo.png` to the image/video models for consistency; use the supplied logo only, never invent or distort it. **This skill drives the Wyren MCP — load the `wyren` skill before any `mcp__wyren__*` call.** It pairs with `storyboard-prompt` (upstream) and `shorts-editor` (downstream edit). Swap `../../brand.md` + `../../assets/` to retarget to another brand.
+Read `../_arca-marketing-assets/brand.md` first and apply its name-usage, persona, logo rules, and colors. Brand assets live in `../_arca-marketing-assets/assets/` — feed `../_arca-marketing-assets/assets/characters.png` (persona) and `../_arca-marketing-assets/assets/logo.png` to the image/video models for consistency; use the supplied logo only, never invent or distort it. **This skill drives the Wyren MCP — load the `wyren` skill before any `mcp__wyren__*` call.** It pairs with `storyboard-prompt` (upstream) and `shorts-editor` (downstream edit). Swap `../_arca-marketing-assets/brand.md` + `../_arca-marketing-assets/assets/` to retarget to another brand.
 
 ---
 
@@ -16,7 +16,7 @@ INTAKE — ASK FIRST:
 Before generating, ask the user for any of these that are not already provided, then wait for their answers:
 1. STORYBOARD REFERENCE — the storyboard image (and shot notes if available). Note whether it is PHOTOGRAPHIC frames or a SCHEMATIC / annotated plan (panel numbers, notes boxes, mock UI) — see STORYBOARD INTERPRETATION; it changes how the video is built.
 2. VIDEO TYPE / STYLE — UGC / phone-shot (default), cinematic / movie-trailer, animation, motion-graphics, product film, skit, etc. Should match the storyboard's declared type. Drives the LOOK and the first-5-seconds cold open. If UGC, the phone-shot styling below applies; if not, follow that type's craft.
-3. BRAND PROFILE — the attached or pasted ../../brand.md (brand name, logo rules, persona, colors).
+3. BRAND PROFILE — the attached or pasted ../_arca-marketing-assets/brand.md (brand name, logo rules, persona, colors).
 4. TARGET MARKET / AUDIENCE — who this is for.
 5. VIDEO SEGMENT — FULL VIDEO / PART 1 / PART 2.
 6. TARGET DURATION.
@@ -115,11 +115,34 @@ Step A — produce a start frame per shot (image model, `imageAI` node):
   for that shot from the character profile + the panel's brief (scene, action, framing), so the frame
   is real-looking footage, not a redraw of the mockup. The panel's mock UI becomes a HyperFrames
   overlay later, not part of this start frame.
+
+PHONE-CAMERA REALISM FOR START FRAMES (UGC types — non-negotiable)
+The #1 failure mode is a start frame that looks like a polished STOCK PHOTO or AI render (even soft
+studio light, model-perfect symmetric faces, plastic skin, centered staged composition, sterile clean
+room). The video model inherits the start frame's look, so a stock-looking frame produces a stock-
+looking clip. Fix it at the frame.
+- Apply the SAME proven realism rules this skill already specifies for the footage — PHONE-SHOT VISUAL
+  STYLE, CHARACTER REALISM, FRAMING, LIGHTING, and DEPTH OF FIELD (all below) — to the START FRAME
+  too. The frame is a paused still from that same casual phone video, NOT a separate photo shoot. In
+  particular reuse: natural skin texture / pores / asymmetry, non-model casting, candid mid-action
+  expression (CHARACTER REALISM); mixed practical light, uneven exposure, blown-out window, mild
+  noise (LIGHTING); off-center imperfect handheld framing (FRAMING); normal phone depth of field, no
+  creamy bokeh (DEPTH OF FIELD); real lived-in clutter (ENVIRONMENT).
+- Add explicit phone-camera tokens to the image prompt: "shot on an iPhone, candid vertical phone
+  snapshot, amateur, mild phone HDR, slight grain, imperfect framing."
+- Always include a negative prompt: stock photo, AI render, 3D render, glossy, airbrushed, retouched,
+  model, supermodel, perfect skin, symmetrical, studio lighting, softbox, beauty lighting, creamy
+  bokeh, shallow depth of field, hyperdetailed, 8k, cinematic, magazine, advertisement, clean, sterile,
+  staged.
+- Applies whether you upscale a photo (path A) or design a fresh frame (path B). If the source/look is
+  already stock-ish (the common failure), explicitly degrade it toward phone realism — grain, uneven
+  light, candid expression, off-center framing — BEFORE generating the clip. (NON-UGC types: follow
+  that type's craft instead — this phone-realism bar is for UGC.)
 - **Keep the face.** When upscaling/cleaning with the image model, instruct it to PRESERVE the
   existing person's identity — same face, hair, age, build, and wardrobe — and only improve quality
   (sharpen, denoise, fix artifacts). Do not let it redraw or beautify into a different face. Use an
   image-edit-capable model (Nanobanana / Nanobanana Pro accept image input) and pass the panel plus
-  the character profile (and `../../assets/characters.png`) as references, with a prompt like "enhance and
+  the character profile (and `../_arca-marketing-assets/assets/characters.png`) as references, with a prompt like "enhance and
   clean this frame, keep the exact same face and person, do not change identity." This face-preserving
   upscale is what makes the per-shot start frames consistent across a multishot/multi-clip video.
 - Image models (category "image"): Nanobanana (Gemini 2.5 Flash Image, 1K, image input, default),
@@ -127,7 +150,7 @@ Step A — produce a start frame per shot (image model, `imageAI` node):
   persona/logo consistent), Imagen 4 Fast / Standard / Ultra (text-only, 1K–2K, no image input).
 - Image sizes: 1K / 2K / 4K depending on model. Aspect ratios: 1:1, 4:3, 9:16, 16:9.
 - Default: Nanobanana Pro at 2K (image input + multi-reference keeps character + logo locked).
-  To feed the persona and logo, pass `../../assets/characters.png` and `../../assets/logo.png` as reference images.
+  To feed the persona and logo, pass `../_arca-marketing-assets/assets/characters.png` and `../_arca-marketing-assets/assets/logo.png` as reference images.
 
 Step B — generate the clips (video model, `videoAI` node):
 - Video models (category "video") and their key knobs:
@@ -169,8 +192,8 @@ FIRST, before generating any shot. Do this for each recurring character (e.g. th
 
 Step 0 — build a character profile BEFORE any shot:
 1. Generate a character profile / face reference with the image model. Use **Nanobanana Pro**
-   (up to 14 reference images, up to 4K) seeded with `../../assets/characters.png` and the persona
-   description from `../../brand.md`. Produce a clean reference: a front face + a 3/4 face (and a
+   (up to 14 reference images, up to 4K) seeded with `../_arca-marketing-assets/assets/characters.png` and the persona
+   description from `../_arca-marketing-assets/brand.md`. Produce a clean reference: a front face + a 3/4 face (and a
    head-to-waist) of the SAME person — consistent face, hair, skin, age, build, and wardrobe —
    rendered in the casual phone-UGC look (natural skin texture, real lighting), NOT glamour/studio.
    One profile image per recurring character.
@@ -225,10 +248,10 @@ Storyboard breakdown or shot notes:
 [PASTE BREAKDOWN HERE]
 
 Brand:
-[BRAND NAME — see brand profile (../../brand.md)]
+[BRAND NAME — see brand profile (../_arca-marketing-assets/brand.md)]
 
 Brand profile:
-[ATTACH OR PASTE ../../brand.md — brand name, logo rules, persona, colors]
+[ATTACH OR PASTE ../_arca-marketing-assets/brand.md — brand name, logo rules, persona, colors]
 
 Logo asset:
 Use the supplied brand logo only if available.
@@ -343,6 +366,33 @@ Avoid:
 Every shot should answer:
 “Why would someone keep watching right now?”
 
+FAST CUTS & MULTI-ANGLE COVERAGE (the UGC editing engine)
+
+A single continuous clip per beat reads as a slow AI ad. Real engaging TikTok/Reels UGC is CUT FAST
+and constantly SWITCHES ANGLE and shot size. This operationalizes the "new beat every 2–4s" rule and
+the CAMERA RULES + TRANSITIONS sections below for GENERATION — and it overrides the one-shot-per-panel
+default in SHOT-BY-SHOT EXECUTION: a storyboard panel is a BEAT, usually several shots, not one clip.
+You cannot cut between angles you never generated.
+
+Rules:
+- Cut roughly every 1–2.5s. No talking shot holds longer than ~3s without a cut, angle change, or
+  reframe. The whole video should feel like many short shots, not a few long ones.
+- Cover each beat from MULTIPLE angles / shot sizes, then cut between them. Generate 2–3 variations per
+  beat drawn from the FRAMING + CAMERA move set: wide/establishing → medium close-up → tight close-up →
+  over-the-shoulder → desk-level POV → reaction insert. Vary framing on EVERY cut (never two same-size
+  shots back to back).
+- Use the video model's multishot where available (Kling V3 multiShot up to 6 shots) to get angle
+  changes inside one generation; otherwise generate several short clips per beat with different framings
+  and assemble them.
+- Intercut B-roll / insert shots between talking shots — hands on the keyboard, the screen, the paper
+  packet, a face reaction, an object. These inserts let you cut on every sentence and hide jumps.
+- Punctuate with the proven TRANSITIONS vocabulary (jump cuts, reaction cuts, quick whip-pans, match
+  cuts, camera repositioning) and snap zooms / handheld punch-ins — never slow dissolves or cinematic moves.
+- Keep continuity locked across the angle changes (same person/face, wardrobe, set, lighting) via the
+  character profile — fast cuts must not become a different person.
+- The actual cutting/assembly is finished in the editor (`shorts-editor` skill): generate enough angle
+  coverage here so that stage can cut fast. Hand it one long clip per beat and it cannot.
+
 PHONE-SHOT VISUAL STYLE
 
 SCOPE: this section (and the CAMERA / FRAMING / LIGHTING / DEPTH OF FIELD / CHARACTER REALISM /
@@ -811,7 +861,8 @@ Avoid:
 
 SHOT-BY-SHOT EXECUTION
 
-For each storyboard panel:
+Each storyboard panel is a BEAT — realize it as several short shots from different angles, not one
+held clip (see FAST CUTS & MULTI-ANGLE COVERAGE). For each panel:
 
 - preserve the main action
 - preserve the emotional beat