arca-marketing-video 2.3.0 → 2.5.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.3.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.5.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.

package/skills/video-prompt/SKILL.md

@@ -1,12 +1,12 @@
 ---
 name: video-prompt
-description: Use when turning a 3×3 storyboard into a finished vertical short-form video of any type (UGC, cinematic / movie-trailer, animation, product film, etc.) via the Wyren MCP — picking image/video models and resolutions, optimizing the TikTok first 5 seconds, keeping character faces consistent across shots, and generating ≤15s clips. 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, 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.
 
 ---
 
@@ -14,9 +14,9 @@ Create a realistic vertical short-form video from the provided 3x3 storyboard re
 
 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 3x3 storyboard image (and shot notes if available).
+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.
@@ -26,7 +26,12 @@ Before generating, ask the user for any of these that are not already provided,
 10. NATIVE AUDIO — whether the video model should synthesize dialogue/sound (only some models support it). Default: on if the chosen model supports `sound`.
 Ask first. Only make smart, briefly stated assumptions for whatever is still missing, and state them briefly. If the user names a budget or "cheapest/fastest", pick the model tier accordingly and say which you picked.
 
-Use the storyboard as the primary visual anchor. Crop the frames, upscale and clean them using image AI and then use those as the first frames. You may generate clips separately video merge them (or merge them using Hyperframes), or you may also do multishot for Video AI decide automatically and smartly.
+Use the storyboard as the PLAN, not as footage to copy. First classify it (see STORYBOARD
+INTERPRETATION below): if the panels are photographic, clean them and use them as start frames; if
+they are schematic / annotated mockups (panel numbers, notes boxes, drawn phone bezels, mock UI), do
+NOT upscale or reproduce them 1:1 — rebuild the video patterned to them, using Wyren clips for the
+live footage and HyperFrames for the on-screen graphics. You may generate clips separately and merge
+them (Wyren or HyperFrames), or use video-model multishot — decide smartly.
 
 VIDEO TYPE SCOPE — read before applying the rules below.
 This skill makes ANY video type. The LOOK follows the chosen VIDEO TYPE; the TikTok retention rules
@@ -43,6 +48,42 @@ rules) apply to EVERY type.
   — render in the chosen type's craft (e.g. for a trailer: cinematic lighting, fast cutting, scale).
   Still keep the retention rules, continuity locks, brand/logo rules, and the first-5s cold open.
 
+STORYBOARD INTERPRETATION — PHOTOGRAPHIC vs SCHEMATIC (read before generating)
+
+Storyboards arrive in two forms. Detect which you have before touching Wyren.
+
+A) PHOTOGRAPHIC frames — each cell is a real / clean image of the actual scene (people, environment),
+   like the clean frame grid the `storyboard-prompt` skill now outputs.
+   → Crop each frame to 9:16 and clean / upscale it into a start frame (GENERATION SETTINGS Step A),
+     keeping the face, then use it as the videoAI startFrame. This is the 1:1-friendly path.
+
+B) SCHEMATIC / ANNOTATED storyboard — each panel is a rough PLAN: a drawn phone bezel, small webcam
+   tiles, mock UI cards, labels, sticky notes, captions, and a notes box (SCENE / TIME / SHOT / ANGLE
+   / MOVE / ACTION / DIALOGUE / AUDIO / TRANSITION / RETENTION / PHONE REALISM). The example
+   "AI Operator Interview" sheet is exactly this kind.
+   → Treat it strictly as a SHOT PLAN, never as pixels. Do NOT upscale it, do NOT reproduce panels
+     1:1, and never render the panel numbers, "Panel N" labels, notes boxes, drawn bezels, or the
+     panel's rough mock graphics as-is into the video. Instead REBUILD each beat:
+     - Read the panel's SCENE / ACTION / SHOT / ANGLE / MOVE / DIALOGUE / AUDIO / TRANSITION /
+       RETENTION as the brief for that shot.
+     - Generate the LIVE FOOTAGE with Wyren (people, faces, desk, reactions, real environment, camera
+       move) using the recurring character profile for face consistency and a fresh start frame
+       DESIGNED for that shot via image AI — not the schematic panel.
+     - Build the ON-SCREEN GRAPHICS with HyperFrames and composite them over the Wyren footage: UI
+       cards, data / deck mockups, split-desk labels, chips, checklists, route-map lines, captions,
+       progress arcs, a REC indicator, the logo — anything that is a graphic, not live action.
+     - Match each panel's layout and intent (what graphic sits where, what the person is doing), but
+       realize it as real footage + clean motion graphics in the chosen VIDEO TYPE's look.
+
+WHO MAKES WHAT (schematic path):
+- Wyren videoAI → live-action clips: people, faces, reactions, hands, environment, props, camera move.
+- Wyren imageAI → designed start frames and any photographic plates feeding the clips.
+- HyperFrames → all overlay graphics, captions, chips, UI / data mockups, transitions, logo, splash,
+  composited on top of the clips (the same graphics layer the `shorts-editor` skill uses).
+Keep diegetic vs overlay clear: a screen the actor really looks at can be a graphic comped onto the
+device; floating captions / chips are HyperFrames overlays. Never bake storyboard annotations into the
+video. If you are unsure which form the storyboard is, ask the user before generating.
+
 CORE OUTPUT
 
 Generate a finished vertical short-form video with:
@@ -67,13 +108,18 @@ options with `mcp__wyren__list_models` and `mcp__wyren__get_model_capabilities`
 the lists below are a current snapshot, not a contract, and per-model resolution/duration/startFrame
 support changes.
 
-Step A — clean storyboard frames into start frames (image model, `imageAI` node):
-- Crop each storyboard panel to 9:16, then upscale/clean it into a usable first frame.
+Step A — produce a start frame per shot (image model, `imageAI` node):
+- PHOTOGRAPHIC storyboard (path A): crop each panel to 9:16, then upscale/clean it into a usable
+  first frame.
+- SCHEMATIC storyboard (path B): do NOT upscale the panel. Use image AI to DESIGN a new start frame
+  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.
 - **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),
@@ -81,7 +127,7 @@ Step A — clean storyboard frames into start frames (image model, `imageAI` nod
   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:
@@ -101,12 +147,18 @@ Step B — generate the clips (video model, `videoAI` node):
 
 Wyren execution flow (per the wyren skill's policy — load it before any `mcp__wyren__*` call):
 1. `list_models` + `get_model_capabilities` to lock the exact image/video model, resolution, mode, duration.
-2. `build_graph`: `imageInput` (storyboard frame, characters.png, logo.png) → `imageAI` (clean/upscale) →
-   `videoAI` (the chosen model/resolution/mode/duration). Use multi-shot or per-clip nodes per the split rule.
+2. `build_graph`: `imageInput` (start-frame source, characters.png, logo.png) → `imageAI` (path A: clean/
+   upscale the photo panel; path B: design a fresh start frame) → `videoAI` (the chosen model/resolution/
+   mode/duration). Use multi-shot or per-clip nodes per the split rule.
 3. `validate_workflow` — resolve warnings with the user.
 4. Estimate cost with `get_pricing` (chain mode) / `estimate_product_cost`; get the user's OK to spend.
 5. `run_workflow` (`userConfirmed: true`), then poll `get_workflow_run_status` every 5s until terminal.
-6. Pull results with `get_node_outputs`. Merge multi-clip output (Wyren or HyperFrames) into the final cut.
+6. Pull the clips with `get_node_outputs`.
+7. GRAPHICS PASS (HyperFrames) — build the on-screen overlay graphics the storyboard calls for (UI/data
+   cards, chips, captions, checklists, route maps, logo, transitions) and composite them over the Wyren
+   clips. For a SCHEMATIC storyboard this pass is required (the mock UI in the panels lives here, not in
+   the footage). Hand off to the `shorts-editor` skill, which owns this HyperFrames graphics + master step.
+8. Merge the clips + graphics into the final cut.
 
 RECURRING CHARACTER CONSISTENCY (multishot / multi-clip)
 
@@ -117,8 +169,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.
@@ -173,10 +225,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.