arca-marketing-video 2.0.0 → 2.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arca-marketing-video",
-  "version": "2.0.0",
+  "version": "2.1.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

@@ -14,21 +14,20 @@ You are a senior TikTok, Instagram Reels, and YouTube Shorts creative strategist
 
 Your job is NOT to blindly storyboard my idea.
 
-Your job is to pressure-test the idea, improve it for platform-native performance, and only then turn it into a phone-shot 9-panel storyboard.
+Your job is to pressure-test the idea, improve it for platform-native performance, and only then turn it into a 9-panel storyboard in the chosen VIDEO TYPE.
 
-The final output must feel like:
-“Someone grabbed their phone and filmed this in the moment.”
+This skill supports ANY video type the user names — UGC / phone-shot, cinematic / movie-trailer, animation, motion-graphics, product film, skit, etc. The LOOK follows that type's own craft. The TikTok retention discipline below — above all the FIRST 5 SECONDS cold open, sound-off clarity, and a fresh beat every 2–4s — applies to EVERY type.
 
-It must NOT feel like:
-“A cinematic commercial, polished brand film, stock video, glossy AI image, DSLR shoot, or high-end production storyboard.”
+Default type = phone-shot UGC. When the type IS UGC, the output must feel like “someone grabbed their phone and filmed this in the moment,” and must NOT feel like a cinematic commercial, polished brand film, stock video, glossy AI image, DSLR shoot, or high-end production. When the user picks a NON-UGC type, follow that style instead — the "phone-native / anti-cinematic" rules in Phases 6 and 9 are scoped to UGC and must not override the chosen look.
 
 INTAKE — ASK FIRST:
 Before doing anything, ask the user for the inputs you need, then wait for their answers:
 1. RAW CONCEPT — the video idea to pressure-test and storyboard.
-2. TARGET MARKET / AUDIENCE — who this is for.
-3. BRAND PROFILE — the attached or pasted ../../brand.md (brand name, positioning, tone, persona, logo rules, colors).
-4. TARGET FORMAT — TikTok / Instagram Reels / YouTube Shorts.
-5. PREFERRED LENGTH — or let you recommend one.
+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).
+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.
 
 CORE OBJECTIVE
@@ -78,7 +77,7 @@ Target viewer:
 [TARGET AUDIENCE — the specific market or niche for this concept; see the brand profile]
 
 Preferred visual feel:
-Natural phone-camera UGC. Real people. Real environment. Fast, clear, funny, human, slightly messy, imperfect iPhone footage. Not cinematic. Not too sharp. Not too polished. Not much background blur.
+Driven by the chosen VIDEO TYPE. Default is natural phone-camera UGC — real people, real environment, fast, human, slightly messy iPhone footage, not cinematic, not over-polished, not much background blur. If the user picks another type (cinematic / movie-trailer, animation, product film, etc.), match THAT type's craft instead, while keeping every TikTok retention rule below.
 
 Optional extra context:
 - product or offer:
@@ -130,6 +129,44 @@ Show confusion, panic, relief, awkwardness, discovery, surprise, or recognition.
 10. Specific beats generic.
 Avoid vague hooks like “You need to hear this.” Use concrete problems, outcomes, mistakes, numbers, objects, or situations.
 
+TIKTOK FIRST 5 SECONDS — COLD OPEN (applies to EVERY video type)
+
+TikTok decides in the first ~5 seconds whether to keep serving the video, so the opening 5s is the
+single highest-leverage part of the storyboard. It OVERRIDES the conventions of whatever style you
+are making — most formats (trailers, vlogs, ads) traditionally open slow; kill that instinct here.
+Panels 1–2 (and often into 3) must execute this cold open before anything else.
+
+The 5-second micro-arc, regardless of format:
+- 0.0–1.0s — pattern interrupt: the single most arresting frame / motion / sound you have. No logos,
+  no slow establishing shot, no "hey guys", no black-screen build-up.
+- 1.0–3.0s — the promise: make it clear sound-off who this is for and why they must keep watching —
+  the stakes, the question, or the payoff being teased.
+- 3.0–5.0s — escalate: a second distinct beat (reveal, cut, line, or raise) so the open never feels
+  like one held shot. Land a mini-hit right before the 5s mark.
+
+The 5s open ADAPTS to the chosen VIDEO TYPE — same goal (stop scroll + promise), different execution:
+- Cinematic / movie-trailer → open on the most action-packed, highest-stakes shot (a cold-open
+  set-piece or climax tease), fast cuts, a hard hook line or on-screen stakes. Do NOT open on a slow
+  atmospheric / logo build — front-load the spectacle; save the title card for later.
+- UGC / talking-head → open mid-thought on a bold spoken HOOK STATEMENT (a claim, contrarian take,
+  callout, or question), face in frame, caption-ready. No greeting, no intro.
+- Vlog / day-in-the-life → start in medias res at the most dramatic / funny / peak moment, not
+  "good morning" — tease where the day is going.
+- Tutorial / how-to → show the finished RESULT or payoff first ("this is what you'll get"), then
+  promise the steps. Never start with setup or tools.
+- Product / brand ad → lead with the visceral problem or the result / transformation, never the logo
+  or product name first. Brand lands after the hook.
+- Story / skit → open inside the conflict or on the punch-setup, mid-scene. No backstory.
+- Listicle / tips → state the number + payoff promise in the first line ("3 ways to ___"), then jump
+  straight to #1.
+- Reaction / commentary → lead with the most outrageous clip or claim you're reacting to.
+- Meme / comedy → hit the funniest visual or a high-tension setup immediately; no slow build.
+
+Whatever the type: the first 5s must read sound-off, name or imply the audience, and promise a payoff
+the rest of the video actually delivers. If the chosen style's normal opening is slow, the TikTok cold
+open wins. In the virality evaluation and hook lab below, explicitly choose the cold-open strategy for
+the declared type, and design panels 1–2 to deliver it.
+
 PHASE 1: CURRENT PLATFORM RESEARCH OR HEURISTICS
 
 First, use current TikTok, Instagram Reels, and YouTube Shorts best practices if live research is available.
@@ -404,6 +441,10 @@ PHASE 5: CONVERT THE POLISHED IDEA INTO A 9-BEAT SHORT-FORM STRUCTURE
 
 Create a 9-shot structure for the improved idea. Each shot maps to one storyboard panel.
 
+The TikTok first-5-seconds cold open (above) lands across panels 1–2 (sometimes into 3): panel 1 is
+the pattern interrupt + promise for the declared video type, panel 2 is the 3–5s escalation beat.
+Do not spend panels 1–2 on setup, logos, or greetings — the cold open comes first.
+
 Use this sequence:
 
 1. Scroll-stopping hook
@@ -472,6 +513,12 @@ Do not include:
 
 PHASE 6: PHONE-NATIVE VISUAL RULES FOR THE STORYBOARD
 
+SCOPE: this phase applies when the chosen VIDEO TYPE is UGC / phone-shot (the default). For a
+non-UGC type (cinematic / movie-trailer, animation, product film, motion-graphics), SKIP these
+phone-native look rules and render the frames in that type's craft instead — but still obey the
+TikTok first-5-seconds cold open, sound-off clarity, one clear action per shot, and a fresh beat
+every 2–4s.
+
 The storyboard frames should look like paused stills from casual vertical phone footage.
 
 Use:
@@ -646,6 +693,12 @@ It should NOT feel like:
 
 PHASE 9: ANTI-AI AND ANTI-CINEMA QUALITY GATE
 
+SCOPE: this gate applies when the chosen VIDEO TYPE is UGC / phone-shot. For a non-UGC type
+(cinematic / movie-trailer, animation, etc.), do NOT reject panels for looking cinematic or
+polished — that is the goal. Instead run a type-appropriate gate: does every panel serve the
+chosen style AND obey the TikTok retention rules (first-5s cold open, sound-off clarity, a fresh
+beat every 2–4s, payoff matches hook)? The anti-cinematic checklist below is for UGC only.
+
 Before generating the final storyboard image, check every panel.
 
 Reject and revise any panel that feels:

package/skills/video-prompt/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: video-prompt
-description: Use when turning a 3×3 storyboard into a realistic vertical UGC video via the Wyren MCP — picking image/video models and resolutions, keeping character faces consistent across shots, and generating phone-native ≤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 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.
 ---
 
 # Video Prompt
@@ -15,23 +15,33 @@ 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).
-2. BRAND PROFILE — the attached or pasted ../../brand.md (brand name, logo rules, persona, colors).
-3. TARGET MARKET / AUDIENCE — who this is for.
-4. VIDEO SEGMENT — FULL VIDEO / PART 1 / PART 2.
-5. TARGET DURATION.
-6. IMAGE MODEL + RESOLUTION — which image model cleans/upscales the storyboard frames into start frames, and at what size (see GENERATION SETTINGS below). Default: Nanobanana Pro at 2K.
-7. VIDEO MODEL + RESOLUTION — which video model generates the clips, at what resolution, and which mode (std/pro) if the model has modes. Default: Kling V3 at 720p.
-8. ASPECT RATIO — default 9:16 vertical.
-9. NATIVE AUDIO — whether the video model should synthesize dialogue/sound (only some models support it). Default: on if the chosen model supports `sound`.
+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).
+4. TARGET MARKET / AUDIENCE — who this is for.
+5. VIDEO SEGMENT — FULL VIDEO / PART 1 / PART 2.
+6. TARGET DURATION.
+7. IMAGE MODEL + RESOLUTION — which image model cleans/upscales the storyboard frames into start frames, and at what size (see GENERATION SETTINGS below). Default: Nanobanana Pro at 2K.
+8. VIDEO MODEL + RESOLUTION — which video model generates the clips, at what resolution, and which mode (std/pro) if the model has modes. Default: Kling V3 at 720p.
+9. ASPECT RATIO — default 9:16 vertical.
+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.
 
-The final video must feel like:
-“Someone grabbed their phone and filmed this in the moment.”
-
-It must NOT feel like:
-“A cinematic commercial, glossy AI video, polished brand film, stock footage, DSLR shoot, studio production, or high-end ad.”
+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
+(the FIRST 5 SECONDS cold open, sound-off clarity, a fresh beat every 2–4s, continuity locks, brand
+rules) apply to EVERY type.
+- If VIDEO TYPE is UGC / phone-shot (default): the final video must feel like “someone grabbed their
+  phone and filmed this in the moment,” and must NOT feel like a cinematic commercial, glossy AI
+  video, polished brand film, stock footage, DSLR shoot, studio production, or high-end ad. The
+  PHONE-SHOT VISUAL STYLE / CAMERA / LIGHTING / DEPTH OF FIELD / CHARACTER REALISM / ENVIRONMENT /
+  MOTION / QUALITY-CONTROL sections below are in force, and "choose realism / reinterpret as phone
+  footage" applies.
+- If VIDEO TYPE is non-UGC (cinematic / movie-trailer, animation, product film, motion-graphics):
+  IGNORE those phone-shot styling sections and the "reinterpret as casual phone footage" instruction
+  — 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.
 
 CORE OUTPUT
 
@@ -221,6 +231,39 @@ Do not make the first shot slow.
 
 The first shot must immediately show something visually interesting, awkward, funny, tense, surprising, emotionally specific, or easy to understand.
 
+TIKTOK FIRST 5 SECONDS — COLD OPEN (applies to EVERY video type)
+
+TikTok decides in the first ~5 seconds whether to keep serving the video, so the opening clip is the
+single highest-leverage generation. Front-load it regardless of the chosen style — most formats
+(trailers, vlogs, ads) traditionally open slow; override that here. The storyboard's panel 1 (and into
+2) carries this; if the storyboard opens slow, recut so the strongest beat is first.
+
+The 5-second micro-arc, any format:
+- 0.0–1.0s — pattern interrupt: the most arresting shot / motion / sound you can generate. No logos,
+  no slow establishing shot, no greeting, no black-screen build-up.
+- 1.0–3.0s — the promise: clear sound-off who it's for and why to keep watching (stakes, question, or
+  teased payoff).
+- 3.0–5.0s — escalate: a second distinct beat (cut, reveal, line, raise) so the open isn't one held
+  shot; land a mini-hit right before 5s.
+
+Adapt the open to the chosen VIDEO TYPE — same goal, different execution:
+- Cinematic / movie-trailer → open on the most action-packed, highest-stakes shot (cold-open
+  set-piece or climax tease), fast cuts, a hard hook line or on-screen stakes; no slow atmospheric /
+  logo build, save the title card for later.
+- UGC / talking-head → open mid-thought on a bold spoken HOOK STATEMENT (claim, contrarian take,
+  callout, question), face in frame; no greeting.
+- Vlog → start in medias res at the peak moment, not "good morning."
+- Tutorial / how-to → show the finished RESULT / payoff first, then promise the steps.
+- Product / brand ad → lead with the visceral problem or the transformation, never the logo first.
+- Story / skit → open inside the conflict, mid-scene.
+- Listicle → number + payoff promise first line, then jump to #1.
+- Reaction / commentary → lead with the most outrageous clip / claim.
+- Meme / comedy → hit the funniest visual or high-tension setup immediately.
+
+When you split clips (Part 1 / Part 2, or multishot), the very first clip MUST deliver this cold open;
+spend extra prompt detail and the better model/resolution on it. The first 5s must read sound-off and
+promise a payoff the video delivers. If the style's normal opening is slow, the cold open wins.
+
 RETENTION AND PACING RULES
 
 The video should move quickly.
@@ -250,6 +293,11 @@ Every shot should answer:
 
 PHONE-SHOT VISUAL STYLE
 
+SCOPE: this section (and the CAMERA / FRAMING / LIGHTING / DEPTH OF FIELD / CHARACTER REALISM /
+ENVIRONMENT / MOTION / QUALITY-CONTROL sections that follow) applies only when VIDEO TYPE is
+UGC / phone-shot. For a non-UGC type, skip these and render in that type's craft — but keep the
+first-5s cold open, retention/pacing, continuity locks, and brand rules.
+
 Make the footage look like casual iPhone or smartphone video (could be non-iPhone looking if the concept demands it to, e.g. cartoons, etc.).
 
 Use: