@editframe/create 0.44.0 → 0.45.1

package/dist/skills/editframe-brand-video-generator/references/typography-personalities.md

@@ -0,0 +1,326 @@
+---
+title: Typography Personalities
+description: What font choices communicate about brand personality and how to pair typefaces effectively in video title sequences.
+type: reference
+order: 7
+---
+
+# Typography Personalities
+
+What font choices signal about brand personality and how to use them in video.
+
+## Font Categories
+
+### Serif Fonts
+
+**Characteristics**: Small decorative strokes at the ends of letters  
+**Personality**: Traditional, established, trustworthy, authoritative, sophisticated  
+**Reading**: Excellent for long-form text, classic feel  
+**Video use**: Titles, formal messaging, established brands, luxury content
+
+#### Classic Serifs
+**Examples**: Times New Roman, Garamond, Baskerville, Caslon  
+**Signals**: Traditional, academic, journalistic, established  
+**Best for**: News, publishing, law, education, heritage brands  
+**Video timing**: Can use longer display times, feels contemplative
+
+#### Modern Serifs
+**Examples**: Didot, Bodoni, Playfair Display  
+**Signals**: Elegant, high-fashion, dramatic, luxurious  
+**Best for**: Fashion, luxury goods, high-end services  
+**Video timing**: Quick, impactful reveals work well
+
+#### Slab Serifs
+**Examples**: Rockwell, Courier, Clarendon, Roboto Slab  
+**Signals**: Strong, bold, industrial, retro, confident  
+**Best for**: Construction, manufacturing, vintage brands, bold statements  
+**Video timing**: Punchy, emphatic timing
+
+### Sans-Serif Fonts
+
+**Characteristics**: Clean lines without decorative strokes  
+**Personality**: Modern, clean, approachable, efficient, minimal  
+**Reading**: Excellent for screens, clear at small sizes  
+**Video use**: Most versatile, works for almost any brand
+
+#### Geometric Sans
+**Examples**: Futura, Avenir, Gotham, Montserrat, Circular  
+**Signals**: Modern, efficient, tech-forward, clean, precise  
+**Best for**: Tech companies, startups, modern brands, minimalist design  
+**Video timing**: Quick cuts work well, feels contemporary
+
+#### Humanist Sans
+**Examples**: Gill Sans, Verdana, Open Sans, Lato  
+**Signals**: Friendly, approachable, warm, readable, human  
+**Best for**: Healthcare, education, community-focused brands  
+**Video timing**: Medium pace, allows comprehension
+
+#### Grotesque Sans
+**Examples**: Helvetica, Arial, Univers, Aktiv Grotesk  
+**Signals**: Neutral, professional, timeless, versatile  
+**Best for**: Corporate, professional services, any brand needing neutrality  
+**Video timing**: Adaptable to any pacing
+
+#### Neo-Grotesque Sans
+**Examples**: Inter, Roboto, San Francisco, Helvetica Neue  
+**Signals**: Contemporary, digital-native, clean, systematic  
+**Best for**: Apps, digital products, modern tech  
+**Video timing**: Quick, snappy, digital feel
+
+### Display Fonts
+
+**Characteristics**: Decorative, attention-grabbing, unique  
+**Personality**: Creative, distinctive, bold, memorable  
+**Reading**: Best for headlines only, not body text  
+**Video use**: Opening titles, brand names, special moments
+
+#### Script/Handwritten
+**Examples**: Brush Script, Pacifico, Dancing Script  
+**Signals**: Personal, creative, casual, handmade, authentic  
+**Best for**: Artisan brands, personal services, creative businesses  
+**Video timing**: Can animate as if being written
+
+#### Decorative/Novelty
+**Examples**: Impact, Bebas Neue, custom display fonts  
+**Signals**: Distinctive, bold, category-specific, memorable  
+**Best for**: Entertainment, youth brands, anything needing strong personality  
+**Video timing**: Short, impactful moments only
+
+### Monospace Fonts
+
+**Characteristics**: Every character takes up same width  
+**Personality**: Technical, precise, code-like, retro-computing  
+**Reading**: Good for code, data, technical content  
+**Video use**: Tech content, data displays, developer tools
+
+**Examples**: Courier, Monaco, Consolas, Source Code Pro  
+**Signals**: Technical, developer-focused, precise, systematic  
+**Best for**: Developer tools, coding content, technical documentation  
+**Video timing**: Can create typewriter effects
+
+## Font Pairing Principles
+
+### Contrast is Key
+Pair fonts that are different enough to create hierarchy but similar enough to feel cohesive.
+
+#### Serif + Sans-Serif (Classic)
+**Example**: Playfair Display (headlines) + Lato (body)  
+**Effect**: Elegant yet approachable, traditional yet modern  
+**Use for**: Balanced brands, professional yet friendly
+
+#### Two Sans-Serifs (Modern)
+**Example**: Montserrat Bold (headlines) + Open Sans (body)  
+**Effect**: Clean, contemporary, cohesive  
+**Use for**: Tech, modern brands, minimalist design
+
+#### Display + Sans-Serif (Bold)
+**Example**: Bebas Neue (headlines) + Roboto (body)  
+**Effect**: Strong personality with readable support  
+**Use for**: Bold brands, entertainment, youth-focused
+
+### Weight Contrast
+Use different weights of the same font family for subtle hierarchy.
+
+**Example**: Inter Black (headlines) + Inter Regular (body)  
+**Effect**: Cohesive, systematic, modern  
+**Use for**: Clean brands, tech, minimalist
+
+## Video-Specific Typography
+
+### Readability Requirements
+
+#### Minimum Display Time
+- **Short word (1-3 letters)**: 1 second
+- **Short phrase (4-8 words)**: 2-3 seconds  
+- **Sentence (10-15 words)**: 3-5 seconds
+- **Paragraph**: Generally avoid in video; break into multiple screens
+
+#### Size Guidelines
+- **Mobile**: Minimum 24px for body text, 36px+ for headlines
+- **Desktop**: Minimum 18px for body text, 30px+ for headlines
+- **TV/Cinema**: Even larger, consider viewing distance
+
+#### Contrast Requirements
+- **White text on dark**: Most readable, classic
+- **Dark text on light**: Clean, modern
+- **Colored text**: Ensure 4.5:1 contrast ratio minimum (WCAG AA)
+- **Text over video**: Use overlay/shadow for readability
+
+### Animation Styles by Font Type
+
+#### Serif Fonts
+- **Fade in/out**: Elegant, classic
+- **Slide from side**: Journalistic, editorial
+- **Scale up**: Dramatic reveal
+- **Avoid**: Bouncy animations, overly playful motion
+
+#### Sans-Serif Fonts
+- **Slide in**: Modern, clean
+- **Fade + slight movement**: Subtle, professional
+- **Quick cuts**: Energetic, contemporary
+- **Scale + fade**: Impactful
+
+#### Display Fonts
+- **Bold entrance**: Scale up, rotate in
+- **Playful motion**: Bounce, wiggle (if brand appropriate)
+- **Dramatic reveal**: Mask wipe, split reveal
+- **Quick impact**: Fast in, hold, fast out
+
+#### Monospace Fonts
+- **Typewriter effect**: Character-by-character reveal
+- **Glitch**: Digital, tech-forward
+- **Cursor blink**: Code-like appearance
+
+### Kinetic Typography
+
+Using motion to enhance meaning:
+
+#### Emphasis
+- **Scale pulse**: Draw attention to key words
+- **Color change**: Highlight important terms
+- **Weight change**: Shift from light to bold
+
+#### Pacing
+- **Fast cuts**: Energetic, urgent, exciting
+- **Slow fades**: Contemplative, emotional, thoughtful
+- **Staggered reveals**: Build suspense, create rhythm
+
+#### Meaning
+- **Direction**: "Up" moves up, "down" moves down
+- **Speed**: "Fast" appears quickly, "slow" appears slowly
+- **Emotion**: "Excited" bounces, "calm" fades gently
+
+## Brand Personality Matrix
+
+### Professional & Trustworthy
+**Fonts**: Classic serifs, grotesque sans (Helvetica, Garamond)  
+**Weight**: Medium to bold, avoid extremes  
+**Animation**: Subtle fades, clean slides  
+**Avoid**: Playful bounces, decorative fonts
+
+### Modern & Innovative
+**Fonts**: Geometric sans, neo-grotesque (Futura, Inter, Circular)  
+**Weight**: Light to bold, embrace extremes  
+**Animation**: Quick cuts, precise movements  
+**Avoid**: Traditional serifs, script fonts
+
+### Friendly & Approachable
+**Fonts**: Humanist sans, rounded fonts (Open Sans, Lato, Nunito)  
+**Weight**: Regular to semi-bold  
+**Animation**: Gentle bounces, smooth transitions  
+**Avoid**: Heavy serifs, harsh angles
+
+### Luxury & Elegant
+**Fonts**: Modern serifs, refined sans (Didot, Bodoni, Avenir)  
+**Weight**: Thin to medium, elegant proportions  
+**Animation**: Slow reveals, graceful fades  
+**Avoid**: Bold slabs, casual scripts
+
+### Bold & Energetic
+**Fonts**: Slab serifs, display fonts (Rockwell, Bebas Neue, Impact)  
+**Weight**: Bold to black  
+**Animation**: Fast entrances, dynamic motion  
+**Avoid**: Delicate serifs, thin weights
+
+### Creative & Unique
+**Fonts**: Display fonts, custom typefaces, interesting scripts  
+**Weight**: Varies by font  
+**Animation**: Playful, unexpected, brand-specific  
+**Avoid**: Generic sans-serifs, overly corporate
+
+### Technical & Precise
+**Fonts**: Monospace, geometric sans (Courier, Roboto Mono, Futura)  
+**Weight**: Regular to medium  
+**Animation**: Typewriter effects, systematic reveals  
+**Avoid**: Decorative fonts, script fonts
+
+## Extracting Typography from Websites
+
+### What to Look For
+
+1. **Heading Fonts**: Usually larger, bolder, more distinctive
+2. **Body Fonts**: Smaller, more readable, used for paragraphs
+3. **Special Fonts**: Logos, callouts, unique elements
+
+### Analyzing Font Choices
+
+#### Single Font Family
+**Signal**: Cohesive, systematic, modern, minimalist  
+**Video approach**: Use weight variation for hierarchy  
+**Common in**: Consumer tech, fintech, design-forward consumer brands
+
+#### Two Font Families
+**Signal**: Balanced, professional, considered design  
+**Video approach**: Use heading font for titles, body font for supporting text  
+**Example brands**: Most professional brands
+
+#### Multiple Fonts
+**Signal**: Either very creative or inconsistent  
+**Video approach**: Identify primary pattern, simplify for video  
+**Note**: May indicate brand needs refinement
+
+### Font Weight Analysis
+
+- **Thin/Light (100-300)**: Elegant, modern, minimal, can feel fragile
+- **Regular (400)**: Neutral, readable, safe
+- **Medium/Semi-Bold (500-600)**: Confident, balanced, professional
+- **Bold (700)**: Strong, impactful, attention-grabbing
+- **Black/Heavy (800-900)**: Very bold, dramatic, powerful
+
+## Video Implementation
+
+### Opening Sequence
+Use brand's most distinctive typography prominently. This creates immediate brand recognition.
+
+**Example structure**:
+```
+[Brand name in brand font]
+↓
+[Tagline in secondary font]
+↓
+[Content begins]
+```
+
+### Content Sections
+Maintain typographic hierarchy:
+- **Headlines**: Brand heading font, larger size
+- **Subheads**: Secondary font or lighter weight
+- **Body text**: Most readable font, appropriate size
+
+### Closing/CTA
+Return to brand typography for strong finish and brand recall.
+
+### Throughout
+- **Consistency**: Same font = same purpose throughout video
+- **Hierarchy**: Size, weight, and position create clear information structure
+- **Breathing room**: Don't crowd text, allow space around typography
+- **Alignment**: Consistent alignment creates professional feel
+
+## Common Mistakes
+
+1. **Too many fonts**: Stick to 2-3 font families maximum
+2. **Poor readability**: Text too small, insufficient contrast, too fast
+3. **Inconsistent usage**: Same font used for different purposes
+4. **Ignoring brand**: Using trendy fonts that don't match brand personality
+5. **Over-animation**: Distracting motion that hurts readability
+6. **Wrong pacing**: Text disappears before viewer can read it
+
+## Quick Reference
+
+| Font Type | Personality | Best For | Animation Style |
+|-----------|-------------|----------|-----------------|
+| Classic Serif | Traditional, trustworthy | Established brands | Subtle fades |
+| Modern Serif | Elegant, luxurious | Fashion, luxury | Dramatic reveals |
+| Geometric Sans | Modern, efficient | Tech, startups | Quick cuts |
+| Humanist Sans | Friendly, warm | Healthcare, education | Gentle motion |
+| Grotesque Sans | Neutral, professional | Corporate | Clean slides |
+| Display | Bold, unique | Entertainment | Dynamic entrances |
+| Monospace | Technical, precise | Developer tools | Typewriter effects |
+
+## Testing Typography in Video
+
+1. **Readability test**: Can you read it in the time allowed?
+2. **Brand alignment**: Does it feel like the brand?
+3. **Hierarchy test**: Is the most important text most prominent?
+4. **Motion test**: Does animation enhance or distract?
+5. **Platform test**: Is it readable on target platform (mobile, TV, etc.)?

package/dist/skills/editframe-brand-video-generator/references/video-archetypes.md

@@ -0,0 +1,86 @@
+---
+title: Video Archetypes
+description: Common video narrative archetypes — explainer, testimonial, product demo, and more — with structure and pacing guidance.
+type: reference
+order: 2
+---
+
+# Video Archetypes by Industry
+
+Quick reference for common video patterns and structures.
+
+## SaaS / Software
+
+**Product Demo (60-90s)**: Hook → Problem → Solution → Features (3-4 max) → Social proof → CTA  
+*Style*: Screen recordings, clean UI | *Pacing*: Medium | *Mistake*: Too many features
+
+**Explainer (30-60s)**: Problem → Solution → How it works (3 steps) → CTA  
+*Style*: Abstract animations, icons | *Pacing*: Fast | *Mistake*: Too technical
+
+**Launch (30-45s)**: Teaser → Problem → Reveal → Key features (2-3) → Availability  
+*Style*: Cinematic, polished | *Pacing*: Building to reveal | *Mistake*: Revealing too early
+
+## E-commerce / Retail
+
+**Product Showcase (15-30s)**: Hero shot → Features/angles → Lifestyle → CTA  
+*Style*: High-quality product photography | *Pacing*: Fast | *Mistake*: Not showing in use
+
+**Brand Story (60-90s)**: Hook → Origin → Values → Products → Community → CTA  
+*Style*: Authentic, emotional | *Pacing*: Slow-medium | *Mistake*: Too sales-y
+
+**Seasonal (15-30s)**: Holiday hook → Products → Offer → CTA  
+*Style*: Holiday-themed, festive | *Pacing*: Fast, urgent | *Mistake*: No urgency
+
+## B2B / Enterprise
+
+**Thought Leadership (60-120s)**: Challenge → Insight → Implications → Approach → CTA  
+*Style*: Professional, data viz | *Pacing*: Slow | *Mistake*: Too self-promotional
+
+**Case Study (90-120s)**: Customer intro → Problem → Solution → Results/metrics → Testimonial → CTA  
+*Style*: Customer footage, data | *Pacing*: Medium | *Mistake*: No real metrics
+
+**Company Overview (60-90s)**: Mission → Problem → Solution → Differentiators → Customers → CTA  
+*Style*: Office/team shots | *Pacing*: Medium | *Mistake*: Too generic
+
+## Finance / Healthcare / Real Estate / Food / Education / Non-Profit / Entertainment
+
+**Finance Trust Builder (45-60s)**: Security hook → Problem → Solution → Trust signals → CTA  
+*Style*: Clean, professional | *Pacing*: Calm | *Mistake*: Too complex
+
+**Healthcare Patient Story (60-90s)**: Intro → Challenge → Journey → Outcome → CTA  
+*Style*: Authentic, hopeful | *Pacing*: Slow, emotional | *Mistake*: HIPAA violations
+
+**Real Estate Property (30-60s)**: Exterior → Rooms → Features → Neighborhood → CTA  
+*Style*: Smooth movement, bright | *Pacing*: Slow | *Mistake*: Camera too fast
+
+**Food Recipe (30-60s)**: Final dish → Ingredients → Process → Reveal → CTA  
+*Style*: Overhead, close-ups | *Pacing*: Fast | *Mistake*: Not enough final product
+
+**Education Course Promo (45-60s)**: Outcome → Problem → Overview → Instructor → CTA  
+*Style*: Dynamic, engaging | *Pacing*: Energetic | *Mistake*: No course content shown
+
+**Non-Profit Impact (60-90s)**: Problem → Beneficiary story → Solution → Impact → CTA  
+*Style*: Authentic, emotional | *Pacing*: Slow | *Mistake*: Exploitation
+
+**Entertainment Trailer (30-60s)**: Hook → Setup → Conflict → Climax tease → Title  
+*Style*: Cinematic, fast cuts | *Pacing*: Building | *Mistake*: Showing too much
+
+## Common Patterns
+
+**Problem-Solution**: Problem → Agitate → Solve → Prove → CTA (*B2B, SaaS, services*)  
+**Transformation**: Before → Catalyst → Journey → After → CTA (*Education, wellness*)  
+**Feature Showcase**: Hook → Feature 1/2/3 → Summary → CTA (*Launches, demos*)  
+**Social Proof**: Hook → Testimonial 1/2/3 → Join CTA (*Trust-building*)  
+**Aspirational**: Dream → Gap → Bridge → Vision → CTA (*Luxury, lifestyle*)
+
+## Length Guidelines
+
+**Platform**: Instagram/TikTok 15-30s | Facebook/LinkedIn 30-60s | YouTube 60-120s | Website 60-90s | Ads 15-30s  
+**Objective**: Awareness 15-30s | Consideration 60-90s | Conversion 30-60s | Education 90-120s  
+**Complexity**: Simple 30-45s | Complex 60-90s | Service 45-60s | Story 60-120s
+
+## Pacing
+
+**Fast (1-2s/scene)**: Social media, high energy | *Risk*: Fatigue  
+**Medium (2-4s/scene)**: Most content | *Risk*: Generic  
+**Slow (4-8s/scene)**: Luxury, emotional | *Risk*: Losing attention

package/dist/skills/editframe-brand-video-generator/references/video-fundamentals.md

@@ -0,0 +1,169 @@
+---
+title: Video Fundamentals
+description: Essential video storytelling concepts — transitions, emotional arcs, pacing, and brand identity — for composition planning.
+type: reference
+order: 1
+---
+
+# Video Fundamentals
+
+Essential concepts for video storytelling: transitions, emotional arcs, and brand identity basics.
+
+## Transitions
+
+Transitions guide attention, set pacing, create meaning, and express brand personality.
+
+### Cut (No Transition)
+**Impact**: Direct, urgent, energetic, modern  
+**Use**: Fast-paced content, related scenes, social media  
+**Avoid**: Slow/contemplative content, dramatic changes  
+**Brand**: Bold, modern, energetic, youthful
+
+### Fade
+**Fade to Black**: Dramatic, final, chapter-ending (0.5-2s)  
+**Fade to White**: Hopeful, clean, fresh start (0.5-1.5s)  
+**Cross Fade**: Smooth, gentle, connected (0.5-2s)  
+**Use**: Major transitions, time passage, emotional moments  
+**Brand**: Sophisticated, thoughtful, premium
+
+### Slide
+**Left/Right**: Progressive, sequential, forward-moving (0.3-0.8s)  
+**Up/Down**: Revealing, building, hierarchical (0.3-0.8s)  
+**Use**: Step-by-step content, timelines, before/after  
+**Brand**: Modern, organized, systematic
+
+### Zoom
+**Zoom In**: Focus, intimacy, discovery  
+**Zoom Out**: Context, scale, revelation  
+**Use**: Emphasis, scale demonstration, dramatic reveals  
+**Brand**: Dynamic, bold, cinematic
+
+### Wipe
+**Impact**: Playful, retro, deliberate  
+**Use**: Segmented content, retro brands, playful messaging  
+**Avoid**: Serious/formal content  
+**Brand**: Playful, creative, retro
+
+### Morph/Blur
+**Impact**: Surreal, dreamlike, transformation  
+**Use**: Abstract concepts, transformations, creative content  
+**Brand**: Creative, innovative, artistic
+
+## Emotional Arcs
+
+Every effective video takes viewers on an emotional journey.
+
+### Problem-Solution Arc
+**Journey**: Frustration → Hope → Relief  
+**Best for**: SaaS, services, B2B, productivity tools  
+**Structure**: Show problem (0-25%) → Introduce solution (25-65%) → Show results (65-90%) → CTA (90-100%)
+
+### Transformation Arc
+**Journey**: Struggle → Journey → Triumph  
+**Best for**: Education, wellness, personal development  
+**Structure**: Before state (0-20%) → Journey/process (20-70%) → After state (70-90%) → "You can too" (90-100%)
+
+### Discovery Arc
+**Journey**: Curiosity → Wonder → Excitement  
+**Best for**: Product launches, innovations, creative work  
+**Structure**: Intriguing question (0-10%) → Gradual reveal (10-70%) → Full reveal (70-90%) → CTA (90-100%)
+
+### Aspiration Arc
+**Journey**: Longing → Possibility → Desire  
+**Best for**: Luxury, lifestyle, aspirational brands  
+**Structure**: Dream state (0-25%) → Path to achieve (25-65%) → Social proof (65-90%) → CTA (90-100%)
+
+### Urgency Arc
+**Journey**: Comfort → Concern → Action  
+**Best for**: Limited offers, time-sensitive opportunities  
+**Structure**: "Seems fine" (0-15%) → Reveal problem (15-65%) → Consequence (65-85%) → Act now (85-100%)
+
+### Empowerment Arc
+**Journey**: Limitation → Capability → Confidence  
+**Best for**: Tools, platforms, education  
+**Structure**: Show limitation (0-25%) → Show empowerment (25-75%) → Show confidence (75-90%) → CTA (90-100%)
+
+### Validation Arc
+**Journey**: Doubt → Recognition → Confidence  
+**Best for**: Community-focused brands, support services  
+**Structure**: Express doubt (0-25%) → Show community (25-75%) → Collective strength (75-90%) → Join (90-100%)
+
+### Surprise Arc
+**Journey**: Expectation → Subversion → Delight  
+**Best for**: Creative brands, entertainment, disruptors  
+**Structure**: Set expectation (0-35%) → Unexpected twist (35-70%) → Reveal connection (70-85%) → CTA (85-100%)
+
+### Reassurance Arc
+**Journey**: Anxiety → Understanding → Calm  
+**Best for**: Healthcare, finance, insurance, complex services  
+**Structure**: Acknowledge worry (0-20%) → Explain clearly (20-65%) → Show help (65-90%) → Reassure (90-100%)
+
+### Momentum Arc
+**Journey**: Static → Movement → Acceleration  
+**Best for**: Growth platforms, momentum-based products  
+**Structure**: Static state (0-20%) → Movement begins (20-65%) → Acceleration (65-90%) → Join (90-100%)
+
+### Choosing the Right Arc
+
+**By Objective:**
+- Awareness: Discovery, Surprise, Aspiration
+- Consideration: Problem-Solution, Transformation, Empowerment
+- Conversion: Urgency, Validation, Reassurance
+
+**By Brand:**
+- Bold/Disruptive: Surprise, Urgency, Discovery
+- Trustworthy/Stable: Reassurance, Problem-Solution, Validation
+- Aspirational/Premium: Aspiration, Transformation, Discovery
+- Empowering: Empowerment, Transformation, Momentum
+
+## Brand Identity Essentials
+
+### Color Associations
+
+**Red**: Energy, urgency, passion, power (food, sports, entertainment)  
+**Blue**: Trust, calm, professionalism, stability (tech, finance, healthcare)  
+**Yellow**: Optimism, happiness, attention (food, children's, budget)  
+**Green**: Growth, health, nature, wealth (sustainability, health, finance)  
+**Orange**: Friendly, creative, affordable, fun (creative, food, budget)  
+**Purple**: Luxury, creativity, innovation (beauty, luxury, creative)  
+**Pink**: Playful, youthful, modern (beauty, fashion, youth brands)  
+**Black**: Sophistication, luxury, power (luxury, premium, modern)  
+**White**: Clean, minimal, pure, open (tech, healthcare, minimal)  
+**Gray**: Professional, neutral, balanced (corporate, tech, modern)
+
+### Typography Signals
+
+**Serif**: Traditional, established, trustworthy, sophisticated  
+- Classic: Academic, journalistic (Times, Garamond)
+- Modern: Elegant, high-fashion (Didot, Bodoni)
+- Slab: Bold, industrial, confident (Rockwell, Courier)
+
+**Sans-Serif**: Modern, clean, approachable, efficient  
+- Geometric: Tech-forward, precise (Futura, Gotham)
+- Humanist: Friendly, warm, readable (Gill Sans, Open Sans)
+- Grotesque: Neutral, professional, timeless (Helvetica, Arial)
+- Neo-Grotesque: Digital-native, contemporary (Inter, Roboto)
+
+**Display**: Creative, distinctive, bold, memorable  
+- Script: Personal, handmade, authentic
+- Decorative: Category-specific, impactful
+
+**Video Usage:**
+- Headlines: Display or bold sans-serif
+- Body text: Clean sans-serif (readable at small sizes)
+- Luxury: Serif or refined sans
+- Tech: Geometric or neo-grotesque sans
+- Friendly: Humanist sans or rounded fonts
+
+### Quick Brand Personality Matrix
+
+| Personality | Colors | Typography | Transitions |
+|-------------|--------|------------|-------------|
+| Bold/Modern | Red, black, bright | Geometric sans, bold | Cut, zoom |
+| Trustworthy | Blue, gray, white | Grotesque sans, classic serif | Fade, cross fade |
+| Luxury | Black, gold, purple | Modern serif, refined sans | Fade, slow transitions |
+| Friendly | Orange, blue, warm | Humanist sans, rounded | Slide, cross fade |
+| Creative | Varied, bold | Display, script, unique | Morph, wipe, surprise |
+| Professional | Blue, gray, neutral | Grotesque sans, classic serif | Cut, fade, minimal |
+| Natural | Green, brown, earth | Humanist sans, organic | Cross fade, gentle |
+| Playful | Bright, varied | Rounded sans, playful display | Wipe, bounce, energetic |

package/dist/skills/editframe-brand-video-generator/references/visual-metaphors.md

@@ -0,0 +1,50 @@
+---
+title: Visual Metaphors
+description: Reference for translating abstract concepts into concrete visual metaphors for use in brand video storytelling.
+type: reference
+order: 8
+---
+
+# Visual Metaphors
+
+Quick reference for representing abstract concepts visually.
+
+**Principles**: Universal recognition, immediate understanding (1-2s), emotional resonance, brand alignment, cultural awareness.
+
+## Concept Library
+
+| Concept | Visuals | Colors | Motion |
+|---------|---------|--------|--------|
+| **Speed** | Motion blur, streaking lines, racing | Red, orange | Fast, energetic |
+| **Security** | Lock, shield, vault, checkmark | Blue, dark | Solid, stable |
+| **Growth** | Upward arrows, rising charts, plant | Green, gold | Upward, expanding |
+| **Connection** | Network nodes, puzzle pieces, hands joining | Warm, varied | Lines connecting |
+| **Simplicity** | Clean space, straight path, single button | White, light | Smooth, effortless |
+| **Complexity** | Gears, circuits, layered elements | Dark, metallic | Multiple parts |
+| **Innovation** | Light bulb, spark, rocket, prism | Bright, varied | Unexpected |
+| **Trust** | Handshake, anchor, foundation, mountain | Blue, earth | Stable, solid |
+| **Transformation** | Butterfly, before/after, morphing | Transitioning | Morphing |
+| **Freedom** | Bird, open door, breaking chains | Bright, open | Expansive |
+| **Collaboration** | Hands together, puzzle, interlocking gears | Multiple colors | Coming together |
+| **Transparency** | Glass, open book, clear water | Light, clear | Revealing |
+| **Efficiency** | Streamlined shape, straight line | Clean, minimal | Smooth, direct |
+| **Intelligence** | Brain, owl, light bulb, chess | Blue, purple | Thoughtful |
+| **Energy** | Lightning, flames, waves, heartbeat | Bright, warm | Dynamic |
+| **Scale** | Ripple, zooming out, expanding circles | Growing bold | Expanding |
+| **Precision** | Bullseye, laser, measuring tools | Clean, precise | Careful, exact |
+
+## Combining Metaphors
+
+- **Speed + Security**: Fast-moving lock (fast AND secure)
+- **Growth + Stability**: Tree on foundation (growing but grounded)
+- **Innovation + Trust**: Light bulb with checkmark (innovative but reliable)
+- **Simplicity + Power**: Single button controlling system (simple but powerful)
+
+## By Industry
+
+**Tech/SaaS**: Networks, circuits, cloud, data flow  
+**Finance**: Growth charts, vaults, balance, bridges  
+**Healthcare**: Heartbeat, care hands, healing, transformation  
+**Education**: Light bulb, growth, journey, unlocking  
+**E-commerce**: Speed, ease, choice, delivery  
+**B2B**: Partnership, efficiency, scale, precision