arca-marketing-video 2.2.0 → 2.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arca-marketing-video",
-  "version": "2.2.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 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.
+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
@@ -638,6 +665,28 @@ Do NOT:
 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.”
 
+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
@@ -776,9 +825,10 @@ Provide the final answer in this exact order:
 4. Improved concept
 5. 9-beat shot structure
 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
+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.