arca-marketing-video 2.4.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.4.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

@@ -6,7 +6,7 @@ description: Use when turning a storyboard into a finished vertical short-form v
 # 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.
 
 ---
 
@@ -16,7 +16,7 @@ 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 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.
@@ -119,7 +119,7 @@ Step A — produce a start frame per shot (image model, `imageAI` node):
   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),
@@ -127,7 +127,7 @@ Step A — produce a start frame per shot (image model, `imageAI` node):
   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:
@@ -169,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.
@@ -225,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.