arca-marketing-video 2.1.0 → 2.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arca-marketing-video",
-  "version": "2.1.0",
+  "version": "2.2.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.",
   "keywords": [
     "skill",

package/skills/storyboard-prompt/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: storyboard-prompt
-description: Use when pressure-testing a short-form video idea and turning it into a phone-native 3×3 (9-panel) storyboard for TikTok / Reels / Shorts — brutal virality scoring, a 10-route hook lab, a polished concept, then a filmable storyboard sheet. Triggers on "storyboard this idea", "is this video concept good", "plan a short". Part of the arca-marketing-video kit.
+description: Use when pressure-testing a short-form video idea and turning it into a 3×3 (or larger) storyboard for TikTok / Reels / Shorts of any video type (UGC, cinematic, animation, etc.) — brutal virality scoring, a 10-route hook lab, a first-5-seconds cold open, then TWO deliverables: a clean frames-only grid image (no text/notes, easy to crop) plus a text breakdown (concept, flow, dialogue, editor notes, style notes). Triggers on "storyboard this idea", "is this video concept good", "plan a short". Part of the arca-marketing-video kit.
 ---
 
 # Storyboard Prompt
@@ -598,7 +598,7 @@ The video panels themselves must NOT contain:
 - watermark text
 - decorative typography
 
-All dialogue, suggested captions, voiceover, SFX, and retention notes must appear only in the separate notes boxes beside or below each panel.
+All dialogue, suggested captions, voiceover, SFX, and retention notes must appear ONLY in the separate TEXT breakdown (Phase 8B), never inside, beside, or below the frames in the storyboard image. The image is frames only.
 
 Text may appear inside the video frame only if it is physically part of the scene, such as:
 - a real computer screen
@@ -635,61 +635,63 @@ Do NOT:
 - force it into every panel
 - make the scene feel like a traditional ad
 
-If exact logo reproduction is not possible, leave the prop simple and include this note in the relevant notes box:
+If exact logo reproduction is not possible, leave the prop simple and add this to the relevant frame's BRAND/LOGO NOTES in the text breakdown:
 “Place supplied brand logo here in post/prop.”
 
-PHASE 8: 3x3 STORYBOARD IMAGE
-
-Create a clean 3x3 storyboard sheet based only on the improved version of the idea, not the raw original idea.
-
-The storyboard sheet should contain:
-- 9 panels arranged in a clean 3x3 grid
-- one vertical 9:16 video frame per panel
-- one separate notes box beside or below each frame
-- readable layout
-- clear progression from beginning to end
-- professional pre-production organization
-- raw, casual, imperfect phone-shot video frames
-
-Each panel should show a different moment:
-
-1. Scroll-stopping hook
-2. Immediate context
-3. Subject or problem introduction
-4. First key action
-5. Tension, contradiction, or reveal
-6. Transformation, solution, or emotional beat
-7. Climax or strongest visual moment
-8. Resolution or result
-9. CTA, loop, final punchline, or memorable closing shot
-
-Each notes box should use this format:
-
-SCENE:
-TIME:
-SHOT:
-ANGLE:
-MOVE:
-ACTION:
-DIALOGUE / VO:
-AUDIO / SFX:
-TRANSITION:
-RETENTION PURPOSE:
-PHONE REALISM NOTE:
-
-Keep notes short and readable. Do not overcrowd the sheet.
-
-STORYBOARD IMAGE STYLE
-
-The sheet itself can be clean and organized.
-
-The video frames themselves must feel raw, phone-shot, imperfect, and human.
-
-The final storyboard should feel like:
-“Here is exactly how we would shoot this on a phone tomorrow.”
-
-It should NOT feel like:
-“Here is a glossy cinematic commercial storyboard.”
+PHASE 8: STORYBOARD FRAME GRID (IMAGE — FRAMES ONLY, NO TEXT)
+
+Output the storyboard as a single clean grid of video frames and NOTHING else. This image is a
+contact sheet meant to be cropped into individual start frames later (by the `video-prompt` skill),
+so it must carry zero annotations. Base it only on the improved idea, not the raw original.
+
+The grid:
+- 9 frames in a 3x3 grid by default. Use more cells (e.g. 3x4, 4x4) only if the concept genuinely
+  needs more than 9 beats; always keep a clean rectangular grid read left-to-right, top-to-bottom.
+- Each cell is one vertical 9:16 frame. All cells identical size, aligned to a strict 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).
+
+The frames must contain NO:
+- panel numbers, labels, titles, or letters
+- notes boxes, captions, subtitles, script, or dialogue text
+- arrows, timecodes, borders-with-text, or annotations of any kind
+- the brand name or any overlay text
+
+(Text may appear inside a frame ONLY when it is physically part of the scene — a real screen, sign,
+mug, notebook, etc. — per Phase 7. Otherwise the frames are clean imagery only.)
+
+The 9 beats, in order:
+1. Scroll-stopping hook   2. Immediate context   3. Subject / problem introduction
+4. First key action       5. Tension / contradiction / reveal   6. Transformation / solution / emotional beat
+7. Climax / strongest visual   8. Resolution / result   9. CTA / loop / punchline / closing shot
+
+The first 1–2 frames must execute the TikTok first-5-seconds cold open for the chosen video type.
+
+PHASE 8B: STORYBOARD TEXT BREAKDOWN (TEXT — NOT in the image)
+
+Output everything written as TEXT, separate from the grid image, so the frames stay clean and
+croppable. Use these sections:
+
+- VIDEO CONCEPT — one tight paragraph: the polished concept + logline, the video type / style, the
+  target viewer, the core promise, the chosen cold-open strategy, and the recommended length.
+- FLOW — the beat-by-beat shot flow, one short block per frame (1–9, or however many), each with:
+  - FRAME # · TIME (range) · RETENTION ROLE
+  - SHOT / ANGLE / MOVE
+  - ACTION (what happens in the frame)
+  - DIALOGUE / VO (OPTIONAL — include only when the beat has a spoken line)
+- VIDEO EDITOR NOTES — what to add in the EDIT, not in the frames: suggested on-screen caption per
+  beat, cut / transition style, SFX and music, pacing, zoom punch-ins, and where the logo / brand
+  splash lands. (These feed the `shorts-editor` skill.)
+- STYLE NOTES — the look the final video must match: video type, lighting, camera feel, color,
+  wardrobe / prop continuity, and the recurring character profile to keep consistent across frames.
+  (These feed the `video-prompt` skill.)
+- BRAND / LOGO NOTES — which frames the supplied logo appears in and how (as a subtle in-world prop),
+  per Phase 7.
+
+Keep it tight and scannable. Dialogue is optional. The clean frame grid (Phase 8) plus this text
+breakdown are the two deliverables — never merge the text into the image.
 
 PHASE 9: ANTI-AI AND ANTI-CINEMA QUALITY GATE
 
@@ -773,21 +775,18 @@ Provide the final answer in this exact order:
 3. Hook lab
 4. Improved concept
 5. 9-beat shot structure
-6. Anti-cinema quality gate summary
-7. 3x3 storyboard image
-8. Audience captions
+6. Quality gate summary (type-appropriate)
+7. Storyboard frame grid (IMAGE — clean frames only, no text/notes/numbers, easy to crop)
+8. Storyboard text breakdown (video concept, flow, dialogue optional, video editor notes, style notes, brand/logo notes)
+9. Audience captions
 
 Do not skip the written strategy before creating the storyboard.
 
 Do not create the storyboard from the raw idea.
 
-Do not make the storyboard cinematic.
-
-Do not make the storyboard AI-polished.
-
-Do not make the people, background, lighting, or camera movement too perfect.
+Do not put any text, notes, script, panel numbers, or annotations inside the storyboard image — frames only. All writing goes in the text breakdown.
 
-The goal is not “pretty.”
+For a UGC storyboard: do not make it cinematic or AI-polished, and do not make the people, background, lighting, or camera too perfect. For a non-UGC type (cinematic / movie-trailer, animation, etc.): match that type's craft instead.
 
 The goal is:
-believable, native, funny, fast, human, high-retention, audience-relevant, and filmable tomorrow on a phone.
+clean croppable frames + a tight text breakdown, with a concept that is native, fast, high-retention, audience-relevant, and front-loaded in the first 5 seconds.