arca-marketing-video 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 aobalitaan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,42 @@
+# arca-marketing-video
+
+A brand-driven short-form marketing content kit, packaged as an agent skill. Four stages
+that chain into a full workflow or run standalone, all driven by one editable brand profile.
+
+```
+npm install arca-marketing-video
+```
+
+## What's inside
+
+| File | Purpose |
+| --- | --- |
+| `SKILL.md` | Skill entry point — routes to the right stage and loads the brand profile first |
+| `brand.md` | The brand profile. Every stage reads brand specifics from here |
+| `references/carousel.md` | 3–5 slide Instagram carousel generator (4:5) |
+| `references/storyboard-prompt.md` | Pressure-test a video idea → phone-native 3×3 storyboard |
+| `references/video-prompt.md` | Turn a 3×3 storyboard into realistic vertical UGC video |
+| `references/shorts-editor.md` | Cut/caption/graphic existing footage into a high-retention short |
+| `scripts/silence_cut.py` | Silence ∪ word-gap cutter for the shorts editor |
+| `scripts/composition.template.html` | HyperFrames composition skeleton for the shorts editor |
+| `assets/logo.png` | Brand logo |
+| `assets/characters.png` | Persona / supporting-character reference sheet |
+| `assets/design-guide.png` | Visual-system reference (palette, type, layout) |
+| `assets/final-cta.png` | End-card / brand-splash still |
+
+## Pipeline
+
+```
+storyboard-prompt  →  video-prompt  →  shorts-editor      (original video)
+carousel                                                  (independent)
+```
+
+## Using with another brand
+
+Replace `brand.md` with your own profile (keep the field structure) and swap the files in
+`assets/`. The four references read everything brand-specific from the profile — no other
+edits needed.
+
+## License
+
+MIT

package/SKILL.md

@@ -0,0 +1,78 @@
+---
+name: arca-marketing-video
+description: Use when producing social marketing content for the Arca brand (or any brand with a brand profile) — Instagram image carousels, short-form video concepts/storyboards for TikTok/Reels/Shorts, AI video generation from a storyboard, or editing raw talking-head/UGC footage into a high-retention vertical short. Triggers on requests to make a carousel, storyboard a video idea, turn a storyboard into video, or cut/caption/add graphics to existing footage.
+---
+
+# Arca Marketing Video
+
+## Overview
+A brand-driven content production kit with four stages. Each stage is a self-contained
+reference (a battle-tested prompt or pipeline). They chain into a full short-form workflow
+or run standalone. Everything brand-specific (name, tone, colors, persona, visual world,
+logo rules) comes from **one brand profile** — `brand.md` — so the kit stays reusable for
+any brand, not just Arca.
+
+**Core principle:** read `brand.md` first, apply it throughout, and pick the smallest stage
+that does the job. Content first, brand world second, decoration last.
+
+## Always do first
+1. **Read `brand.md`.** It holds every brand specific the references depend on. Apply its
+   name-usage rules, tone, audience, colors, persona, visual world, and logo rules everywhere.
+2. **Run the stage's INTAKE.** Each reference asks for its required inputs first (topic,
+   audience, concept, format, duration, storyboard). Ask, then wait. Only make smart,
+   briefly-stated assumptions for whatever is still missing — never stall.
+
+## When to use which stage
+
+| The user wants… | Use | Output |
+| --- | --- | --- |
+| An Instagram image carousel (3–5 slides) | `references/carousel.md` | Slide copy + per-slide image-gen prompts + caption |
+| A short-form video idea pressure-tested + storyboarded | `references/storyboard-prompt.md` | Virality eval, hook lab, 9-beat plan, 3×3 storyboard sheet |
+| A storyboard turned into real-feeling vertical video | `references/video-prompt.md` | 9:16 UGC video (split into ≤15s clips) |
+| Existing footage cut tighter, captioned, graphics/SFX added | `references/shorts-editor.md` | Mastered 9:16 short (HyperFrames + ffmpeg) |
+
+The natural chain for an original video: **storyboard-prompt → video-prompt → shorts-editor**
+(concept → storyboard → generated footage → engaging edit). Carousel is independent.
+
+## Stages
+
+### 1. Carousel generator — `references/carousel.md`
+Turns a vague topic into a 3–5 slide Instagram carousel (4:5, 1080×1350) that stops the
+scroll, teaches one idea per slide, and positions the brand subtly. Outputs per-slide
+headline/copy/visual-direction plus a standalone content-first image-gen prompt per slide,
+then a caption. Heavy on anti-clutter and restraint rules.
+
+### 2. Storyboard prompt — `references/storyboard-prompt.md`
+Does NOT blindly storyboard the idea. It pressure-tests the concept (brutal virality score),
+runs a 10-route hook lab, polishes the idea, then renders a phone-native 3×3 (9-panel)
+storyboard sheet. Output feels "filmed on a phone tomorrow", never cinematic.
+
+### 3. Video prompt — `references/video-prompt.md`
+Converts a 3×3 storyboard into realistic vertical UGC video. Runs **alongside the Wyren MCP**:
+intake asks for the image model + resolution, video model + resolution, mode, aspect ratio, and
+native-audio toggle, then drives Wyren (`list_models` → `build_graph` → `validate_workflow` →
+cost estimate → `run_workflow` → poll). 9:16 by default, split into ≤15s clips (Part 1 = panels
+1–5, Part 2 = panels 6–9 for 20–30s). Preserves the 9 beats, characters, props, and setting;
+forces phone-shot realism over polish. For multishot / multi-clip, it first locks a recurring
+**character profile + bible** (face/hair/wardrobe) so the persona stays identical across every shot.
+**Load the `wyren` skill before any `mcp__wyren__*` call.**
+
+### 4. Shorts editor — `references/shorts-editor.md`
+Edits existing talking-head/interview/UGC footage into a high-retention short: silence-cut →
+synced captions → face-safe graphic chips + zoom punch-ins → SFX + brand splash. Built on
+HyperFrames + ffmpeg + faster-whisper. Ships with `scripts/silence_cut.py` and
+`scripts/composition.template.html`.
+
+## Brand assets (`assets/`)
+Use the supplied assets only — do not invent or distort a logo.
+- `assets/logo.png` — the Arca logo. Place subtly as an in-world prop (sticker, mug,
+  notebook, badge) or a small consistent carousel mark. Visible, never dominant.
+- `assets/characters.png` — the persona / supporting-character reference sheet (the Arca
+  Navigator + supporting operators) for consistent illustration and video casting.
+- `assets/design-guide.png` — visual-system reference (palette, type, layout feel).
+- `assets/final-cta.png` — the end-card / brand-splash still for the shorts editor and
+  carousel CTA slide.
+
+## Adapting to another brand
+Replace `brand.md` with the new brand's profile (same field structure) and swap the files in
+`assets/`. The four references read everything from the profile — no other edits needed.

package/brand.md

@@ -0,0 +1,259 @@
+BRAND PROFILE
+
+This file holds everything specific to ONE brand. The carousel, storyboard, and video
+prompt templates read from this profile so they stay reusable for any brand or niche.
+
+HOW TO USE:
+- Replace every field below with your own brand's details.
+- Delete the parts that do not apply to you.
+- The example values shown here are filled in for the "Arca" brand. Treat them as a
+  worked example of how to fill each field, not as required content.
+- When you run any of the prompt templates, paste or attach this file as the BRAND PROFILE.
+
+If a field is left blank, the templates may proceed on smart, clearly stated assumptions.
+
+====================================================================
+1. BRAND NAME
+====================================================================
+Brand name:
+Arca
+
+Name usage rules:
+- Always write the brand name as "Arca" or "arca.ph".
+- Never write it in all caps as "ARCA" unless it appears inside a small logo mark.
+- The brand should feel premium, human, practical, and audience-first.
+
+(For your brand: state exactly how the name should and should not be written.)
+
+====================================================================
+2. WEBSITE / HANDLE
+====================================================================
+arca.ph
+
+====================================================================
+3. WHAT THE BRAND DOES / POSITIONING
+====================================================================
+Arca helps companies hire AI-trained Filipino professionals who support research,
+content, admin, operations, documentation, light automation, AI-assisted workflows,
+and execution systems.
+
+====================================================================
+4. CORE BRAND IDEA
+====================================================================
+Arca is the execution navigation layer for founders.
+
+The customer's business is full of rough water: backlog, context switching, messy
+workflows, half-used tools, slow hiring, missed follow-ups, and too much founder-led
+execution. Arca gives them a crew, a route, and a system.
+
+====================================================================
+5. BRAND SHOULD FEEL LIKE / SHOULD NOT FEEL LIKE
+====================================================================
+The brand SHOULD feel like:
+- practical execution
+- calm navigation
+- trusted support
+- human operators
+- founder leverage
+- modern work systems
+- real people using AI to move work forward
+
+The brand should NOT feel like:
+- futuristic AI
+- sci-fi
+- robotic
+- childish
+- toy-like
+- overly cute
+- comic-book inspired
+- generic SaaS
+- plain corporate white slides
+
+====================================================================
+6. TONE
+====================================================================
+Sharp, practical, audience-aware, credible, direct, modern, and human.
+
+- No hype.
+- No generic "AI will change everything" language.
+- No fluffy startup motivation.
+- No cringe founder-bro language.
+- Make it feel like the content understands real audience pain: backlog, slow hiring,
+  messy operations, context switching, inconsistent execution, underused AI tools, and
+  lack of follow-through.
+
+====================================================================
+7. TARGET AUDIENCE
+====================================================================
+Founders, operators, agency owners, startup leaders, and executives who are overloaded,
+moving fast, hiring too slowly, and trying to get more leverage from people + AI.
+
+(For your brand: describe exactly who you are talking to and what they are struggling with.)
+
+====================================================================
+8. VISUAL WORLD
+====================================================================
+A mature "execution navigation" style, applied with restraint. The visual world is built
+from: maritime navigation, execution systems, tactical work, mature human operators, and
+recurring real-world work objects.
+
+Primary visual metaphors to choose from (use ONE per slide):
+- rough water = operational chaos
+- calm route map = clear execution path
+- lighthouse = direction and clarity
+- task stack = backlog or execution load
+- checklist card = systemized work
+- split desk = before / after contrast
+- operator at desk = human execution support
+- route line = movement from problem to outcome
+- blocked route = execution bottleneck
+- clean desk = delegated clarity
+- calendar delay = slow hiring or waiting
+- finished task stack = shipped outcomes
+
+Supporting motifs (use sparingly, 1-2 max per slide):
+- sail-cut geometric panel
+- subtle wave divider
+- small compass icon
+- route pin
+- yellow marker underline
+- field notebook
+- coffee mug
+- laptop
+- project folder
+- workflow map
+- lighthouse silhouette
+- task card
+- checklist card
+
+(For your brand: list your own primary metaphors and supporting motifs. If you do not
+have a defined visual world yet, leave this blank and the template will rely on generic
+design-restraint principles.)
+
+====================================================================
+9. RECURRING OBJECT SYSTEM
+====================================================================
+Recurring objects create continuity without clutter. Use only 1-2 per slide:
+- field notebook
+- blue coffee mug
+- route map
+- yellow sticky note
+- checklist card
+- laptop with subtle brand sticker
+- compass icon
+- lighthouse silhouette
+- task card stack
+- workflow map
+- calendar card
+- project folder
+- headphones
+- small sail icon
+- wave ribbon
+
+Objects should be large enough to read at mobile size. Avoid many small papers, tiny
+sticky notes, dense dashboards, miniature UI panels, or tiny labels.
+
+====================================================================
+10. CHARACTER DIRECTION + MAIN PERSONA
+====================================================================
+Characters are allowed but must feel mature, grounded, and editorial. Use characters as
+part of the brand world, not as cartoon mascots.
+
+Character style:
+- mature 2D editorial illustration
+- adult proportions
+- confident, calm expressions
+- subtle shading
+- clean modern shapes
+- realistic operator energy
+- no exaggerated faces, comic-panel style, 3D toy texture, Pixar-like proportions, or
+  childish mascot energy
+- no speech bubbles unless very minimal
+
+Main recurring persona:
+The Arca Navigator — a calm operator and practical guide who understands messy workflows,
+is audience-supportive, confident but not cheesy, human, capable, and trustworthy.
+May wear subtle maritime-inspired clothing (navy jacket, subtle striped shirt detail,
+minimal cap or no cap, small brand logo patch only if it does not distract, practical
+workwear). Avoid costume-like sailor cliches, oversized hats, or mascot styling.
+
+Supporting characters (mature editorial illustrations of real professionals):
+- operations specialist
+- research analyst
+- content producer
+- customer support lead
+- project lead
+- automation assistant
+
+(For your brand: describe your persona and supporting characters, or leave blank if you
+do not use characters.)
+
+====================================================================
+11. COLOR PALETTE
+====================================================================
+Primary colors:
+- Deep Ocean Blue: #0E74B3
+- Bright Azure: #1098CE
+- Electric Cyan: #13C8ED
+- Sun Yellow: #FED21A
+- Charcoal: #111111
+- White: #FFFFFF
+
+Supporting neutral:
+- Warm Off-White: #F7F5EF or similar
+
+Color usage:
+- Deep blue anchors the system.
+- Bright azure and cyan create energy and movement.
+- Sun yellow is used sparingly for emphasis, highlights, route markers, CTAs, warnings,
+  or key words.
+- Off-white can be used for editorial warmth; avoid making every slide plain white.
+- Use charcoal for readable body text.
+
+Role mapping (used by the templates):
+- BRAND BACKGROUND: Warm Off-White (#F7F5EF) or Deep Ocean Blue (#0E74B3)
+- BRAND ACCENT: Deep Ocean Blue (#0E74B3)
+- BRAND HIGHLIGHT: Sun Yellow (#FED21A)
+- BRAND BODY TEXT: Charcoal (#111111)
+
+(For your brand: fill in your own hex values and map them to background / accent /
+highlight / body text roles.)
+
+====================================================================
+12. TYPOGRAPHY
+====================================================================
+- Clean modern sans-serif consistent with the brand website.
+- Modern, audience-facing, highly readable.
+- Strong bold headlines, medium-weight subheads, readable body text.
+- Avoid overly condensed block fonts, distressed/grungy type, childish rounded fonts,
+  futuristic techno fonts, and all-caps as the default.
+- Use the brand name in title case ("Arca").
+
+====================================================================
+13. HOOK EXAMPLES (tailor to your audience)
+====================================================================
+- "Your backlog is not a productivity problem."
+- "You don't need another tool. You need an operator."
+- "The founder bottleneck is follow-through."
+- "Most teams are buying AI without assigning ownership."
+- "Execution is where AI strategies go to die."
+- "Hiring slowly is costing more than you think."
+- "Your tools are not the system."
+
+====================================================================
+14. CTA EXAMPLES (tailor to your audience)
+====================================================================
+- "Build the support layer before the backlog breaks you."
+- "Stop trying to do every workflow yourself."
+- "Give AI a trained human operator."
+- "Hire for execution leverage, not just extra hands."
+- "Build the crew before the work floods back in."
+- "Arca helps founders plug in AI-trained Filipino professionals who can move the work forward."
+
+====================================================================
+15. LOGO ASSET
+====================================================================
+- Use the supplied brand logo only. Do not invent or distort a logo.
+- Place it subtly as an in-world prop (laptop sticker, tote bag, mug, notebook, badge,
+  small poster, desk object) or, for carousels, a small consistent mark.
+- Keep it visible but never dominant. It should feel incidental, not like an ad.

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "arca-marketing-video",
+  "version": "1.0.0",
+  "description": "Brand-driven short-form marketing content kit (Claude/agent skill): Instagram carousels, phone-native storyboards, AI video generation, and high-retention shorts editing — all driven by a single brand profile.",
+  "keywords": [
+    "skill",
+    "claude",
+    "agent-skill",
+    "marketing",
+    "short-form-video",
+    "tiktok",
+    "reels",
+    "shorts",
+    "carousel",
+    "storyboard",
+    "ugc",
+    "arca"
+  ],
+  "author": "aobalitaan",
+  "license": "MIT",
+  "files": [
+    "SKILL.md",
+    "brand.md",
+    "references/",
+    "assets/",
+    "scripts/",
+    "README.md"
+  ]
+}