arca-marketing-video 2.1.0 → 2.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arca-marketing-video",
-  "version": "2.1.0",
+  "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.",
   "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 polish pass that makes the idea catchy and engaging with a strong hook and brand-aligned messaging, a first-5-seconds cold open, a clarification checkpoint before image generation, 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
@@ -321,15 +321,20 @@ For each hook, provide:
 - retention risk
 - 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)?
 
-Then rank the top 3 hooks and choose the single strongest hook.
+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).
 
 The chosen hook must be:
 - specific
 - visual
 - fast
 - emotionally clear
-- easy to film on a phone
+- 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
+- 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
 - not over-explained
 - not dependent on perfect captions
@@ -407,6 +412,28 @@ Create an ending that naturally connects back to the first frame if possible.
 
 21. Anti-cinematic note
 
+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:
+- 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).
+- 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.
+
+CATCHY & ENGAGING BAR
+The polished idea must clear a stickiness bar, not just a clarity bar:
+- A memorable, quotable line or phrase the viewer could repeat or comment (without being clickbait).
+- ONE sharp, specific concept — a concrete object / number / situation, never a vague topic.
+- A reason to finish AND a reason to share or save (sending it makes the viewer look smart or seen).
+- A title and logline that sound scroll-stopping on their own.
+If the concept is only "fine," sharpen the hook, raise the stakes, or make the line more quotable before
+moving on — do not storyboard a flat idea.
+
 The improved version should be:
 - more specific
 - more visual
@@ -598,7 +625,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 +662,85 @@ 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.”
+CLARIFICATION CHECKPOINT — ASK BEFORE GENERATING THE IMAGE
+
+Before generating the storyboard frame grid (Phase 8), STOP and check whether anything material is
+still unclear or based on an assumption. If so, ask the user a few focused questions and WAIT for
+answers — do not generate frames on shaky assumptions, because the image is expensive to redo.
+
+Ask when any of these are unresolved or you had to guess them:
+- the chosen video type / style and overall look
+- the single chosen hook and the core message (and that the brand-message alignment is right)
+- the specific characters / persona, wardrobe, setting / location, and key props
+- any concrete facts the frames would depict (product, screen content, on-scene text)
+- tone, must-includes, must-avoids, and how prominent the brand / logo should be
+- number of frames (default 9) and aspect ratio
+
+Also surface, in one short list, the key assumptions you are about to bake into the frames, and ask
+the user to confirm or correct them.
+
+If everything is already clear and confirmed (the user gave enough detail or already approved the
+polished concept), say so in one line and proceed — do not stall or pad with needless questions.
+
+Only after the user confirms or says proceed do you generate the image.
+
+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 +824,19 @@ 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. Clarification checkpoint — confirm direction and ask any open questions before generating the image (skip with one line if already clear and approved)
+8. Storyboard frame grid (IMAGE — clean frames only, no text/notes/numbers, easy to crop)
+9. Storyboard text breakdown (video concept, flow, dialogue optional, video editor notes, style notes, brand/logo notes)
+10. 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.