@stacksjs/defaults 0.75.109 → 0.75.111

package/ai/skills/stacks-marketing-social/references/short-form-video.md

@@ -0,0 +1,237 @@
+# Short-Form Video: Hooks, Scripts & Strategy
+
+Detailed reference for creating short-form video content on TikTok, Instagram Reels, and YouTube Shorts.
+
+---
+
+## Video Hook Library
+
+### Curiosity Hooks (Best for engagement)
+
+**The "Secret" Formula:**
+- "The secret to [outcome] that nobody talks about"
+- "I found a feature in [product/platform] that saves me [specific time/result]"
+- "I can't believe this actually works..."
+
+**The Unexpected Discovery:**
+- "I tried [thing] for 30 days and I was NOT expecting this"
+- "This completely changed how I think about [topic]"
+- "Nobody talks about this, but..."
+
+**The Question:**
+- "Why does nobody talk about this?"
+- "Am I the only one who didn't know this?"
+- "The reason [common thing] doesn't work is..."
+
+### Value Hooks (Best for saves)
+
+**The Promise:**
+- "How to [achieve outcome] in [specific timeframe]"
+- "[Number] [things] that will [benefit]"
+- "[Topic] in 60 seconds: the [N] things that matter"
+
+**The Hack/Shortcut:**
+- "[Outcome] hack that actually works"
+- "The [adjective] way to [outcome]"
+- "If you're struggling with [problem], watch this"
+
+**The Warning:**
+- "Stop doing [common practice]. It cost me [specific result]."
+- "[Number] mistakes that are killing your [results]"
+- "Why [thing you think is good] is actually hurting you"
+
+### Story Hooks (Best for watch time)
+
+**The Transformation:**
+- "3 months ago, I [bad state]. Today, I [good state]."
+- "Here's how I went from [before] to [after]"
+- "I used to think [old belief]. Then [specific event] happened."
+
+**The Failure:**
+- "I made a huge mistake with [topic]"
+- "Here's why I stopped [common practice]"
+- "I lost [something significant] because of this mistake"
+
+**The Journey:**
+- "So this just happened..."
+- "This cut my [task] from [X] to [Y]"
+- "Let me tell you about the time I [interesting situation]"
+
+### Controversial Hooks (Best for comments)
+
+- "Unpopular opinion: [bold statement]"
+- "[Common advice] is actually wrong"
+- "I'm going to get hate for this, but..."
+- "Most [audience] get this completely wrong"
+
+---
+
+## Scripting Template
+
+```markdown
+## Video: [Working Title]
+
+**Platform:** TikTok / Reels / Shorts
+**Length:** XX seconds
+**Format:** [Talking head / Slideshow / Demo / Screen recording]
+
+### Hook (0-3 sec)
+- Visual: [What viewer sees]
+- Audio: [What they hear]
+- Text overlay: [On-screen text]
+
+### Body (3-X sec)
+- [Timestamp] - [What happens/what you say]
+- [Timestamp] - [Next beat]
+- [Continue...]
+
+### CTA (final 3-5 sec)
+- Verbal: [What you say]
+- Text: [On-screen text]
+- Action: [Follow, comment, link in bio, etc.]
+
+### Production Notes
+- Music/sound: [Trending sound or music choice]
+- B-roll needed: [List any clips needed]
+- Graphics: [Any text animations or overlays]
+```
+
+---
+
+## Additional Video Structures
+
+### The Story Arc (45-60 sec)
+
+```
+[0-3s]  Hook: Tease the outcome
+[3-15s] Setup: Context and stakes
+[15-45s] Journey: What happened
+[45-55s] Resolution: The result
+[55-60s] Lesson/CTA
+```
+
+Best for: Personal stories, case studies, testimonials
+
+### The POV/Skit (15-30 sec)
+
+```
+[0-3s]  Setup: Text overlay sets the scene
+[3-25s] Performance: Act out the relatable scenario
+[25-30s] Punchline or twist
+```
+
+Best for: Relatable content, humor, niche communities
+
+---
+
+## Visual Patterns
+
+### Talking Head
+- Good lighting (ring light or window light)
+- Eye contact with camera
+- Hand gestures for emphasis
+- Interesting background (bookshelf, plants, studio setup)
+
+### Slideshow/Carousel Video
+- Strong visual on each slide (2-4 seconds per slide)
+- Text overlays with key points
+- Consistent style/branding
+- Voiceover or trending sound
+
+### Screen Recording
+- Zoom in on important areas
+- Add cursor highlight or click animations
+- Keep movements smooth and intentional
+- Overlay your face in corner (optional but boosts engagement)
+
+### B-Roll Heavy
+- Show don't tell
+- Quick cuts (1-3 seconds per shot)
+- Match cuts to voiceover beats
+- Mix wide, medium, and close-up shots
+
+---
+
+## Audio Strategy
+
+### When to Use Trending Sounds
+- Entertainment/lifestyle content where the sound fits your message
+- When the trend is still rising (check platform trending pages)
+- Don't use when it distracts from your message or is already declining
+
+### When to Use Original Audio
+- Educational content where you're speaking
+- Storytimes and personal narratives
+- Product demos and tutorials
+- Building a recognizable brand voice
+
+### Voiceover Tips
+- Speak slightly faster than normal conversation
+- Vary your tone - avoid monotone delivery
+- Pause for emphasis on key points
+- Record in a quiet space, use noise removal
+- AI voices work for faceless content (ElevenLabs, etc.)
+
+### Music Selection
+- Match energy to content (upbeat for tips, emotional for stories)
+- Avoid copyrighted music on Reels/Shorts
+- Use platform music libraries for safety
+- Lower music volume under voiceover (ducking)
+
+---
+
+## Posting Strategy
+
+### Optimal Posting Times (test your audience)
+
+| Platform | Best Times (local) |
+|----------|-------------------|
+| TikTok | 7-9 AM, 12-3 PM, 7-11 PM |
+| Reels | 9 AM, 12 PM, 7-9 PM |
+| Shorts | 12-3 PM, 7-9 PM |
+
+### Frequency Recommendations
+
+| Goal | Minimum | Optimal |
+|------|---------|---------|
+| Growing | 1/day | 2-4/day |
+| Maintaining | 3/week | 1/day |
+| Testing | 2/week | 5/week |
+
+### Batch Creation Workflow
+
+1. **Ideate** (30 min): Generate 10-20 concepts
+2. **Script** (1 hour): Write scripts for 5-10 videos
+3. **Batch film** (2 hours): Record all talking head content
+4. **Edit** (2-3 hours): Edit and add captions
+5. **Schedule** (30 min): Queue for optimal times
+
+---
+
+## Analytics & Iteration
+
+### Metrics That Matter
+
+| Metric | What It Tells You |
+|--------|-------------------|
+| Watch time % | Is content engaging throughout? |
+| Completion rate | Did hook + content deliver? |
+| Saves | Is content valuable enough to revisit? |
+| Shares | Is content worth spreading? |
+| Comments | Did content spark conversation? |
+| Follows | Did viewer want more from you? |
+
+### What to Test
+
+1. **Hooks**: Same content, different opening
+2. **Length**: 15 sec vs 30 sec vs 60 sec
+3. **Format**: Talking head vs slideshow vs demo
+4. **Time**: Morning vs afternoon vs evening
+5. **CTA**: Different calls to action
+
+### When to Pivot
+
+- 5+ videos with <1% completion rate → change hooks
+- High views but low follows → check CTA and content-audience fit
+- High saves but low shares → content is valuable but not social
+- Lots of comments but negative → lean into controversy or adjust tone

package/ai/skills/stacks-marketing-social/references/x-algorithm.md

@@ -0,0 +1,69 @@
+# X (Twitter) Algorithm Playbook
+
+How the X "For You" feed ranks posts, based on xAI's open-sourced algorithm ([xai-org/x-algorithm](https://github.com/xai-org/x-algorithm), May 2026 release - the Phoenix ranker and Grox content-understanding pipeline), and what to change in your posting practice because of it.
+
+**Sourcing note:** the release publishes the ranking *structure* (which signals are scored and how they combine) but not the weight *values* (`params.rs` is withheld). Rules below are tagged **[verified]**when the mechanism is visible in the code,**[reported]** when the specific number or magnitude comes from secondary analysis of the release. Structure changes slowly; reported numbers age fast - treat them as directionally true.
+
+## How ranking works (60-second version)
+
+1. Candidate posts come from two sources: accounts the viewer follows (Thunder) and ML-retrieved posts from the global corpus (Phoenix retrieval). You are always competing for out-of-network reach, not just your followers' feeds.
+2. Filters remove ineligible posts *before* scoring: too old, already seen or served, muted keywords, blocked/muted authors.
+3. The Phoenix transformer predicts a probability for each engagement type - not one "quality score" but ~15 separate predictions.
+4. Final score = weighted sum of those probabilities. Positive actions add; predicted negative actions (not-interested, mute, block, report) subtract.
+5. An author-diversity scorer then decays the scores of repeated authors within a feed response, so your posts compete with each other.
+
+The model has no hand-engineered "quality" features - it learns entirely from engagement histories. You can't optimize for the algorithm directly; you optimize for the specific *behaviors* it predicts. And notice what those behaviors are: staying to read, sending to a friend, following the author, joining the conversation. Those are the things a well-told story produces. Storytelling and genuine connection with your audience aren't a separate strategy from the mechanics below - they're what the mechanics reward. The rules tune distribution; the story earns the engagement.
+
+## The signals your post is scored on [verified]
+
+Every signal below is a separate weighted term in the scoring code:
+
+| Signal | What to notice |
+|--------|---------------|
+| Favorite (like) | The baseline - and the weakest lever, given how many other signals exist |
+| Reply | Conversation-starting posts earn a distinct signal |
+| Repost | Public amplification |
+| Quote **and** quoted-click | Two separate terms: engagement on a quote post *and* clicks through to the quoted post both score |
+| Click | Opening the post detail |
+| Profile click | Clicking through to your profile is its own scored action |
+| Share, share-via-DM, share-via-copy-link | **Three separate share signals** - private sharing is explicitly modeled, not lumped into one |
+| Video quality view | Only paid if video duration exceeds a minimum threshold (`MIN_VIDEO_DURATION_MS`); short clips earn zero video credit |
+| Dwell (two forms) | Time spent reading is scored both as a threshold and as continuous time |
+| Photo expand | Tapping to enlarge an image |
+| Follow author | A post that converts a viewer into a follower earns its own signal |
+| Not interested / mute / block / report | **Negative weights** - the model predicts these too, and they subtract from your score |
+
+## The 10 rules
+
+1. **Open with a specific claim in the first 8 words.** [reported] Dwell is scored two ways [verified], and scroll-past is the dwell-killer. Don't warm up - the hook *is* the post.
+
+2. **Wait ~60 minutes between original posts.** [reported number] The author-diversity scorer is verified: within a feed response, each additional post from the same author gets a decayed score. Clustered posts cannibalize each other's reach.
+
+3. **Name your topic in the first 10 words.** [reported] Topic-based candidate sourcing and followed-topic hydration are verified in the pipeline - the algorithm routes posts to topic followers, but only if it can tell what the topic is. Vague musings don't get routed.
+
+4. **Write for the DM-forward, not the like.** [verified structure; relative weight reported] Share-via-DM is its own scored signal. The test for every post: "would someone send this to a friend?" beats "would someone like this?"
+
+5. **Quote tweets score twice.** [verified structure] Quote engagement and quoted-click are separate terms. Quoting with added insight beats plain reposting - for both parties.
+
+6. **Write for the follow.** [verified structure] Follow-author is a distinct signal. Posts that make a stranger think "I want more of this" outperform posts that make them think "ha, nice."
+
+7. **Make them curious enough to click your profile.** [verified structure] Profile clicks are scored. This is the mechanical argument for a strong bio and pinned post: the algorithm rewards posts that trigger the click, and your profile converts it.
+
+8. **Name specific things.** [verified mechanism] Two reasons: specificity is what enables topic routing (rule 3), and the muted-keyword filter removes posts *pre-scoring* - generic engagement-bait phrases are commonly muted; specific nouns ("Claude", "Stripe") rarely are.
+
+9. **Video must clear the minimum duration - with captions.** [verified mechanism; ~8s reported] The video-quality-view weight only applies above `MIN_VIDEO_DURATION_MS`. Below the threshold, video earns zero video credit. Captions serve the dwell signals (most viewing is muted).
+
+10. **Be present for the first 30 minutes.** [reported] Early replies compound: each reply you answer is a fresh engagement event, and reply chains feed the dwell and conversation signals. Post when you can stay, not when the scheduler fires.
+
+## What kills reach [verified]
+
+- **Muted keywords** - filtered before scoring even happens. Spammy CTA phrases and rage-bait vocabulary are widely muted.
+- **Predicted negative actions** - if your post pattern-matches to content people block, mute, or hit "not interested" on, it's penalized *before anyone acts*. Engagement bait doesn't just annoy humans; it's a modeled negative.
+- **Posting bursts** - author-diversity decay (rule 2). Your second post in an hour starts handicapped.
+- **Already-seen content** - reposting the same content quickly hits the previously-seen/served filters. Evergreen reruns need spacing.
+
+## Caveats
+
+- **Weights are unpublished.** Claims like "shares are worth N× likes" are inference, not source. The safe conclusion is which behaviors are scored *at all* - and that private shares, follows, profile clicks, and dwell each matter independently.
+- **This ages fast.** The repo gets updated releases; if you're reading this long after May 2026, check [xai-org/x-algorithm](https://github.com/xai-org/x-algorithm) for changes before treating numbers as current.
+- **These rules are X-specific.** The general principles (hook early, specificity, reply presence) travel to other platforms; the mechanics (60-minute spacing, quote-double-counting, video minimums) do not.

package/ai/skills/stacks-marketing-video/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Corey Haines
+
+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/ai/skills/stacks-marketing-video/NOTICE.md

@@ -0,0 +1,13 @@
+# Source and license
+
+Adapted from [coreyhaines31/marketingskills](https://github.com/coreyhaines31/marketingskills),
+revision [1efedbc5148b54b2f0f6c6c9fe0be62e151c7fff](https://github.com/coreyhaines31/marketingskills/tree/1efedbc5148b54b2f0f6c6c9fe0be62e151c7fff),
+upstream skill `video`, version 2.2.1.
+The original MIT copyright and permission notice is in [LICENSE](LICENSE).
+
+Stacks supplies a namespaced entrypoint, shared implementation guidance, mapped
+related-skill links, and regular-hyphen copy. The playbook and its supporting
+references/templates are retained. Tool integrations remain optional linked
+references; upstream CLI programs, servers, and packaging scripts are not
+bundled or installed. Source examples are illustrative and changing platform
+facts require verification.

package/ai/skills/stacks-marketing-video/PLAYBOOK.md

@@ -0,0 +1,330 @@
+> Adapted playbook. The [shared Stacks workflow](../stacks-marketing/WORKFLOW.md) governs implementation, current facts, and authorization.
+
+
+# Video
+
+You are an expert video producer who helps create marketing videos using AI generation models, AI avatars, and programmatic video frameworks. Your goal is to help users produce professional video content efficiently - from product demos and explainers to social clips and ads.
+
+## Before Starting
+
+**Check for product marketing context first:**
+Read the established product context described in [the shared workflow](../stacks-marketing/WORKFLOW.md) before asking questions.
+
+Gather this context (ask if not provided):
+
+### 1. Video Goal
+- What type of video? (Product demo, explainer, testimonial, social clip, ad, tutorial)
+- What's the target platform? (YouTube, TikTok/Reels/Shorts, website, ads, sales deck)
+- What's the desired length?
+
+### 2. Production Approach
+- Do you need a human presenter? (AI avatar vs. voiceover vs. screen recording)
+- Do you have existing footage or assets? (Screenshots, logos, product UI)
+- Do you need generated footage? (AI-generated scenes, B-roll)
+- Is this a one-off or a template for repeated use?
+
+### 3. Technical Context
+- What's your tech stack? (Node.js, Python, etc.)
+- Do you have API keys for any video tools?
+- Budget constraints? (Some tools charge per minute of video)
+
+---
+
+## Choosing Your Approach
+
+Pick the right tool for the job:
+
+| Approach | Best For | Tools | When to Use |
+|----------|----------|-------|-------------|
+| **Programmatic** | Templated, data-driven, batch video | Remotion, Hyperframes | Product updates, personalized videos, recurring content |
+| **AI Generation** | Original footage from text/image prompts | Veo 3, Runway, Kling, Seedance | B-roll, hero shots, creative visuals you can't film |
+| **AI Avatars** | Talking-head presenter without filming | HeyGen, Synthesia | Explainers, tutorials, multilingual content |
+| **Editing/Repurposing** | Cutting long-form into short clips | Descript, Opus Clip, CapCut | Podcast/webinar → social clips |
+
+---
+
+## Programmatic Video
+
+Build videos with code. Best for repeatable, templated, or data-driven video at scale.
+
+### Hyperframes (HTML/CSS - recommended for agents)
+
+Open-source, Apache 2.0, from HeyGen. Uses plain HTML/CSS/JS - no framework DSL to learn. LLM-native: AI models generate better HTML than React components.
+
+```bash
+bunx --bun hyperframes init my-video && cd my-video
+bunx --bun hyperframes preview               # live preview
+bunx --bun hyperframes render -o output.mp4  # render index.html
+```
+
+**Key concept:** A composition is one HTML file. The root element sets the canvas and length (`data-composition-id`, `data-duration`, `data-width`, `data-height`), each element on screen is a clip (`class="clip"` with `data-start`, `data-duration`, `data-track-index`), and a paused GSAP timeline registered in `window.__timelines` drives the animation. The `hyperframes` package is CLI-only; to render from code, use `@hyperframes/producer` (`createRenderJob` + `executeRenderJob`). Full syntax and a working example: [Hyperframes integration guide](https://github.com/coreyhaines31/marketingskills/blob/1efedbc5148b54b2f0f6c6c9fe0be62e151c7fff/tools/integrations/hyperframes.md).
+
+**Best for:** Product announcements, changelogs, data-driven reports, personalized outreach videos.
+
+**Why agents prefer it:** Plain HTML/CSS means any coding agent can write a composition without learning a framework. Deterministic rendering - same input always produces identical output.
+
+### Remotion (React)
+
+Mature open-source framework. More powerful than Hyperframes but requires React knowledge.
+
+```bash
+bunx --bun create-video@latest
+```
+
+**Key concept:** React components are frames. Props drive content. Render locally or via Remotion Lambda (AWS) for scale.
+
+```tsx
+export const ProductDemo: React.FC<{ title: string; features: string[] }> = ({
+  title, features
+}) => {
+  const frame = useCurrentFrame();
+  return (
+    <AbsoluteFill style={{ background: "#000", color: "#fff" }}>
+      <h1>{title}</h1>
+      {features.map((f, i) => (
+        <Sequence from={i * 30} key={i}>
+          <p>{f}</p>
+        </Sequence>
+      ))}
+    </AbsoluteFill>
+  );
+};
+```
+
+**Best for:** Complex animations, interactive previews, large-scale batch rendering (Lambda).
+
+### When to Pick Which
+
+| Factor | Hyperframes | Remotion |
+|--------|-------------|----------|
+| Agent compatibility | Better (plain HTML) | Good (React) |
+| Animation complexity | GSAP timelines (plus CSS) | Advanced (Spring, interpolate) |
+| Batch rendering | Local | Lambda (AWS) for scale |
+| Learning curve | Minimal | Moderate (React + Remotion API) |
+| License | Apache 2.0 | Company license for commercial use |
+
+---
+
+## AI Video Generation
+
+Generate original footage from text or image prompts. Use for B-roll, hero visuals, and scenes you can't practically film.
+
+### Model Comparison
+
+| Model | Resolution | Max Duration | Best For | Cost |
+|-------|-----------|-------------|----------|------|
+| **Veo 3** (Google) | Up to 1080p (4K varies) | Variable | Top overall quality, synced audio | API-based |
+| **Runway Gen-4** | Up to 4K | ~10 sec/gen | Motion control, temporal consistency, edit-style workflows | $12-76/mo |
+| **Kling 2.5/3.0** (Kuaishou) | Up to 1080p | Up to 2 min | Long-take generation, lower per-second cost | ~$0.03/sec |
+| **Seedance** (ByteDance) | Up to 1080p | Short clips | Fast generation, strong motion fidelity at low cost, batch-friendly | Per-credit |
+| **Hailuo / MiniMax** | Up to 1080p | Short clips | Character consistency across shots | Per-credit |
+| **Pika 2.x** | 1080p | Short clips | Quick effects, image-to-video, lower bar to entry | Per-credit |
+| **Hunyuan Video / Wan 2** | 720p-1080p | Variable | Open-source self-hosted; full control, no API fees | Free (GPU) |
+
+**Quick picks**:
+- **Highest quality + audio**: Veo 3
+- **Batch / volume / cost**: Kling, Seedance
+- **Character consistency across multiple shots**: Hailuo
+- **Self-hosted, brand-controlled**: Hunyuan Video or Wan 2 (open weights)
+- **Storyboard → video workflow**: Runway, LTX Studio
+- **Image-to-video from a still you already have**: Kling, Pika, Runway
+
+### Prompting for Video Models
+
+Good video prompts specify: **subject + action + camera + style + mood**
+
+```
+A close-up shot of hands typing on a laptop keyboard,
+shallow depth of field, warm office lighting,
+camera slowly pulls back to reveal a modern workspace,
+cinematic color grading, 4K
+```
+
+**Common mistakes:**
+- Too vague ("a person working") - add specifics
+- Ignoring camera movement - specify dolly, pan, static
+- Forgetting style - "cinematic," "documentary," "commercial"
+- Requesting text in video - AI models struggle with readable text
+
+**For detailed prompting guides**: See [references/ai-video-prompting.md](references/ai-video-prompting.md)
+
+### When to Use AI Generation vs. Stock
+
+| Use Case | AI Generation | Stock Footage |
+|----------|:---:|:---:|
+| Exact scene you imagined | Yes | Rarely matches |
+| Consistent style across clips | Yes | Hard to match |
+| Recognizable real locations | No (hallucinations) | Yes |
+| Specific products/brands | No (use programmatic) | No |
+| Quick B-roll | Either works | Faster |
+
+---
+
+## AI Avatars
+
+Create talking-head videos without filming. An AI avatar delivers your script with realistic lip-sync, expressions, and gestures.
+
+### HeyGen (recommended - has MCP server)
+
+Best lip-sync and micro-expressions. 230+ avatars, 140+ languages.
+
+**Agent integration:** HeyGen has an official MCP server - AI agents can generate avatar videos directly.
+
+| Plan | Videos | Duration |
+|------|--------|----------|
+| Free | 3/mo | 3 min max |
+| Creator | Unlimited | 5 min |
+| Business | Unlimited | 20 min |
+
+Check [heygen.com/pricing](https://www.heygen.com/pricing) for current prices.
+
+**Best for:** Product explainers, feature announcements, personalized sales outreach, multilingual content.
+
+**Custom avatars:** Upload a 2-5 min video of yourself to create a digital twin. Looks and sounds like you, generates videos from text scripts.
+
+### Synthesia
+
+Full-body avatars with expressive body language. Built-in script generation from URLs/docs.
+
+**Best for:** Corporate training, compliance videos, enterprise presentations where professional tone > realism.
+
+### When to Use Avatars vs. Other Approaches
+
+| Scenario | Use Avatar | Use Instead |
+|----------|:---:|-------------|
+| Recurring content (weekly updates) | Yes | - |
+| Multilingual versions | Yes | - |
+| Personalized outreach at scale | Yes | - |
+| Authentic founder content | No | Film yourself |
+| Product UI walkthrough | No | Screen recording |
+| Creative/artistic video | No | AI generation |
+
+---
+
+## Editing & Repurposing Tools
+
+Turn existing content into multiple video formats.
+
+| Tool | What It Does | Best For |
+|------|-------------|----------|
+| **Descript** | Transcript-based editing - edit video by editing text | Cleaning up interviews, podcasts, webinars |
+| **Opus Clip** | Auto-clips long videos, scores virality potential | Long-form → short-form at scale |
+| **CapCut** | Visual effects, captions, platform-native styling | TikTok/Reels polish |
+| **Captions.ai** | Auto-captions, eye contact correction, AI dubbing | Solo talking-head content |
+
+### Repurposing Workflow
+
+```
+Long-form content (podcast, webinar, demo)
+    ↓
+Descript: Clean up, remove filler, polish
+    ↓
+Opus Clip: Auto-extract 5-10 best moments
+    ↓
+CapCut: Add captions, effects, platform styling
+    ↓
+Distribute: TikTok, Reels, Shorts, LinkedIn
+```
+
+### Reverse-Engineer a Viral Edit
+
+To replicate the *style* of a video edit you admire - the cut rhythm, caption treatment, punch-ins, on-screen text, sound design - decompose it into a reusable **edit spec** (a beat sheet) and apply it to your own footage. Pull the reference with **watch-video** (visual/multimodal mode extracts frames at the cut points) or **social-fetch**, extract the edit anatomy beat by beat, and output a per-beat table plus the 3-5 signature moves that make the edit recognizable. Review the beat sheet once before executing it (in Remotion/Hyperframes, CapCut, or an AI restyle tool). Copies the editing grammar, never the reference's footage/script/music. Full method: [references/edit-anatomy.md](references/edit-anatomy.md).
+
+---
+
+## Video Production Workflows
+
+### Product Demo Video
+
+1. **Script** the key features and value props (use copywriting skill)
+2. **Screen record** the product flow
+3. **Programmatic overlay** - use Hyperframes/Remotion for titles, callouts, transitions
+4. **AI B-roll** - generate establishing shots or lifestyle scenes with Veo/Runway
+5. **Voiceover** - record yourself or use AI avatar for narration
+6. **Export** at platform-appropriate specs
+
+**Scripted in-app recording:** for a repeatable demo of a web app flow (re-recorded every release, run against a local build), drive the app with Playwright and add subtitles, a visible cursor, and optional TTS narration. See [references/product-demo-recording.md](references/product-demo-recording.md) for the workflow, step modes, and local-app gotchas.
+
+### Explainer Video
+
+1. **Script** the problem → solution → CTA arc
+2. **Choose presenter** - AI avatar (HeyGen) or voiceover + visuals
+3. **Build visuals** - programmatic slides, screen recordings, AI-generated scenes
+4. **Add captions** - always, for accessibility and engagement
+5. **Export** - landscape for YouTube/website, vertical for social
+
+### Batch Social Clips
+
+1. **Create master template** in Hyperframes/Remotion
+2. **Feed data** - product features, testimonials, stats
+3. **Render batch** - one template, many variations
+4. **Add platform-specific captions** via CapCut or Captions.ai
+5. **Schedule** across platforms
+
+---
+
+## Agent-Native Video Pipeline
+
+The most powerful setup combines tools that agents can control directly:
+
+```
+Agent writes script (from product context)
+    ↓
+Hyperframes: Generate templated video (HTML → MP4)
+    and/or
+HeyGen MCP: Generate avatar video from script
+    and/or
+Veo/Runway API: Generate B-roll footage
+    ↓
+Agent assembles final cut
+    ↓
+Output: Ready-to-publish video
+```
+
+**What makes this agent-native:**
+- Hyperframes uses HTML - any coding agent can generate it
+- HeyGen MCP server - agents call it directly
+- Video model APIs - standard HTTP requests
+- No manual editing step required
+
+---
+
+## Common Mistakes
+
+1. **Starting with tools, not strategy** - decide what video you need before picking tools
+2. **AI-generated text in video** - models can't reliably render readable text; use programmatic overlays instead
+3. **Uncanny valley avatars** - if avatar quality matters, invest in HeyGen Creator+ tier
+4. **No captions** - 85% of social video is watched without sound
+5. **Wrong aspect ratio** - 9:16 for social, 16:9 for YouTube/website, 1:1 for feeds
+6. **Over-producing** - authentic often outperforms polished, especially on TikTok
+
+---
+
+## Task-Specific Questions
+
+1. What type of video do you need? (Demo, explainer, social clip, ad, tutorial)
+2. Do you need a human presenter or can it be voiceover/text?
+3. Is this a one-off or a repeatable template?
+4. What platform is it for? (This determines aspect ratio and length)
+5. Do you have existing assets to work with? (Screenshots, footage, scripts)
+6. What's your budget for video tools?
+
+---
+
+## Tool Integrations
+
+| Tool | Type | MCP | Guide |
+|------|------|:---:|-------|
+| **HeyGen** | AI avatars | Yes | [heygen.md](https://github.com/coreyhaines31/marketingskills/blob/1efedbc5148b54b2f0f6c6c9fe0be62e151c7fff/tools/integrations/heygen.md) |
+| **Hyperframes** | Programmatic video | - | [hyperframes.md](https://github.com/coreyhaines31/marketingskills/blob/1efedbc5148b54b2f0f6c6c9fe0be62e151c7fff/tools/integrations/hyperframes.md) |
+| **Remotion** | Programmatic video | - | [remotion.dev](https://www.remotion.dev/docs) |
+| **Runway** | AI generation | - | [runwayml.com/docs](https://docs.dev.runwayml.com) |
+
+---
+
+## Related Skills
+
+- **stacks-marketing-social**: For video content strategy, hooks, and what to post
+- **stacks-marketing-ad-creative**: For paid video ad creative and iteration
+- **stacks-marketing-copywriting**: For video scripts and messaging
+- **stacks-marketing-psychology**: For hooks and persuasion in video