@hienlh/ppm 0.9.79 → 0.9.81

package/.opencode/skills/copywriting/scripts/extract-writing-styles.py

@@ -0,0 +1,308 @@
+#!/usr/bin/env python3
+"""
+Extract Writing Styles from assets/writing-styles/ directory.
+
+Supports multiple file types:
+- Text: .md, .txt
+- Documents: .pdf, .docx, .xlsx, .pptx (via document_converter.py)
+- Media: .jpg, .jpeg, .png, .webp, .mp4, .mov (via gemini_batch_process.py)
+
+Usage:
+    python extract-writing-styles.py --list         # List available style files
+    python extract-writing-styles.py --style <name> # Extract specific style
+    python extract-writing-styles.py --all          # Extract all styles
+    python extract-writing-styles.py --all --json   # Output as JSON
+"""
+
+import argparse
+import json
+import os
+import re
+import subprocess
+import sys
+from pathlib import Path
+from typing import Any, Dict, List, Optional
+
+
+# File type categories
+TEXT_FORMATS = {'.md', '.txt'}
+DOC_FORMATS = {'.pdf', '.docx', '.xlsx', '.pptx'}
+IMAGE_FORMATS = {'.jpg', '.jpeg', '.png', '.webp', '.heic'}
+VIDEO_FORMATS = {'.mp4', '.mov', '.avi', '.mkv'}
+ALL_FORMATS = TEXT_FORMATS | DOC_FORMATS | IMAGE_FORMATS | VIDEO_FORMATS
+
+
+def find_project_root(start_dir: Path) -> Path:
+    """Find project root by looking for .claude directory."""
+    for parent in [start_dir] + list(start_dir.parents):
+        if (parent / '.claude').exists():
+            return parent
+    return start_dir
+
+
+PROJECT_ROOT = find_project_root(Path(__file__).parent)
+STYLES_DIR = PROJECT_ROOT / 'assets' / 'writing-styles'
+AI_MULTIMODAL_SCRIPTS = PROJECT_ROOT / '.claude' / 'skills' / 'ai-multimodal' / 'scripts'
+
+
+def get_style_files() -> Dict[str, Any]:
+    """List all style files in the writing-styles directory."""
+    if not STYLES_DIR.exists():
+        return {'error': f'Directory not found: {STYLES_DIR}', 'files': []}
+
+    files = []
+    for f in STYLES_DIR.iterdir():
+        if f.is_file() and f.suffix.lower() in ALL_FORMATS:
+            files.append({
+                'name': f.stem,
+                'path': str(f),
+                'type': get_file_type(f),
+                'size': f.stat().st_size
+            })
+
+    return {'files': sorted(files, key=lambda x: x['name']), 'directory': str(STYLES_DIR)}
+
+
+def get_file_type(file_path: Path) -> str:
+    """Categorize file by type."""
+    ext = file_path.suffix.lower()
+    if ext in TEXT_FORMATS:
+        return 'text'
+    if ext in DOC_FORMATS:
+        return 'document'
+    if ext in IMAGE_FORMATS:
+        return 'image'
+    if ext in VIDEO_FORMATS:
+        return 'video'
+    return 'unknown'
+
+
+def extract_text_content(file_path: Path) -> str:
+    """Extract content from text files (.md, .txt)."""
+    try:
+        return file_path.read_text(encoding='utf-8')
+    except Exception as e:
+        return f'Error reading file: {e}'
+
+
+def extract_document_content(file_path: Path, verbose: bool = False) -> str:
+    """Extract content from documents using document_converter.py."""
+    converter = AI_MULTIMODAL_SCRIPTS / 'document_converter.py'
+    if not converter.exists():
+        return f'Error: document_converter.py not found at {converter}'
+
+    output_file = STYLES_DIR / f'.temp_{file_path.stem}_extraction.md'
+
+    try:
+        cmd = [
+            sys.executable, str(converter),
+            '--input', str(file_path),
+            '--output', str(output_file),
+            '--prompt', '''Extract the writing style characteristics from this document.
+Identify: tone, vocabulary, sentence structure, rhetorical devices, formatting patterns.
+Output as structured markdown with clear sections.'''
+        ]
+        if verbose:
+            cmd.append('--verbose')
+
+        result = subprocess.run(cmd, capture_output=True, text=True, timeout=300)
+
+        if output_file.exists():
+            content = output_file.read_text(encoding='utf-8')
+            output_file.unlink()  # Clean up temp file
+            return content
+        else:
+            return f'Conversion failed: {result.stderr}'
+
+    except subprocess.TimeoutExpired:
+        return 'Error: Document conversion timed out'
+    except Exception as e:
+        return f'Error: {e}'
+
+
+def extract_media_content(file_path: Path, verbose: bool = False) -> str:
+    """Extract writing style from media using gemini_batch_process.py."""
+    processor = AI_MULTIMODAL_SCRIPTS / 'gemini_batch_process.py'
+    if not processor.exists():
+        return f'Error: gemini_batch_process.py not found at {processor}'
+
+    try:
+        prompt = '''Analyze this content and identify any writing style characteristics visible.
+Look for: text overlays, captions, typography choices, messaging tone, branding voice.
+Describe the writing style in terms of: tone, vocabulary level, sentence structure, key phrases.
+Output as structured analysis.'''
+
+        cmd = [
+            sys.executable, str(processor),
+            '--files', str(file_path),
+            '--task', 'analyze',
+            '--prompt', prompt
+        ]
+
+        result = subprocess.run(cmd, capture_output=True, text=True, timeout=300)
+        return result.stdout if result.stdout else result.stderr
+
+    except subprocess.TimeoutExpired:
+        return 'Error: Media analysis timed out'
+    except Exception as e:
+        return f'Error: {e}'
+
+
+def extract_style_content(file_path: Path, verbose: bool = False) -> Dict[str, Any]:
+    """Extract writing style content from any supported file type."""
+    if not file_path.exists():
+        return {'error': f'File not found: {file_path}'}
+
+    file_type = get_file_type(file_path)
+
+    if file_type == 'text':
+        content = extract_text_content(file_path)
+    elif file_type == 'document':
+        content = extract_document_content(file_path, verbose)
+    elif file_type in ('image', 'video'):
+        content = extract_media_content(file_path, verbose)
+    else:
+        return {'error': f'Unsupported file type: {file_path.suffix}'}
+
+    # Parse the content for style information
+    result = {
+        'file': str(file_path),
+        'type': file_type,
+        'title': '',
+        'sections': [],
+        'styles': [],
+        'rawContent': content
+    }
+
+    # Extract title from first H1
+    title_match = re.search(r'^#\s+(.+)$', content, re.MULTILINE)
+    if title_match:
+        result['title'] = title_match.group(1).strip()
+
+    # Extract sections (H2 headers)
+    for i, match in enumerate(re.finditer(r'^##\s+(.+)$', content, re.MULTILINE)):
+        result['sections'].append({
+            'title': match.group(1).strip(),
+            'lineNumber': content[:match.start()].count('\n') + 1
+        })
+
+    # Extract style entries from tables
+    table_pattern = r'\|.*?\|.*?\|.*?\|'
+    for match in re.finditer(table_pattern, content, re.MULTILINE):
+        row = match.group(0)
+        if '---' not in row and 'Style' not in row:
+            cols = [c.strip() for c in row.split('|') if c.strip()]
+            if len(cols) >= 2:
+                result['styles'].append({
+                    'name': re.sub(r'\*+', '', cols[0]),
+                    'keywords': cols[1] if len(cols) > 1 else '',
+                    'description': ' | '.join(cols[2:]) if len(cols) > 2 else ''
+                })
+
+    return result
+
+
+def format_output(data: Dict[str, Any], as_json: bool = False) -> str:
+    """Format output for display."""
+    if as_json:
+        return json.dumps(data, indent=2, ensure_ascii=False)
+
+    if 'error' in data:
+        return f"Error: {data['error']}"
+
+    output = []
+
+    if 'files' in data:
+        # List mode
+        output.append('# Available Writing Styles\n')
+        output.append(f"Directory: {data['directory']}\n")
+
+        if not data['files']:
+            output.append('\nNo style files found. Add files to assets/writing-styles/')
+        else:
+            output.append('\n| Style | Type | Size |')
+            output.append('|---|---|---|')
+            for f in data['files']:
+                size_kb = f['size'] / 1024
+                output.append(f"| {f['name']} | {f['type']} | {size_kb:.1f}KB |")
+
+    elif 'title' in data:
+        # Single style extraction
+        if data.get('title'):
+            output.append(f"# {data['title']}\n")
+
+        output.append(f"**File Type:** {data.get('type', 'unknown')}\n")
+
+        if data.get('styles'):
+            output.append(f"\n## Extracted Styles ({len(data['styles'])})\n")
+            for s in data['styles'][:30]:  # Limit to 30 styles
+                output.append(f"### {s['name']}")
+                output.append(f"**Keywords:** {s['keywords']}\n")
+
+        if data.get('sections'):
+            output.append('\n## Sections\n')
+            for s in data['sections']:
+                output.append(f"- {s['title']} (line {s['lineNumber']})")
+
+    return '\n'.join(output)
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        description='Extract writing styles from assets/writing-styles/ directory',
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog='''
+Supported formats:
+  Text:      .md, .txt
+  Documents: .pdf, .docx, .xlsx, .pptx (requires GEMINI_API_KEY)
+  Images:    .jpg, .jpeg, .png, .webp (requires GEMINI_API_KEY)
+  Videos:    .mp4, .mov (requires GEMINI_API_KEY)
+
+Examples:
+  python extract-writing-styles.py --list
+  python extract-writing-styles.py --style default
+  python extract-writing-styles.py --all --json
+        '''
+    )
+
+    parser.add_argument('--list', action='store_true', help='List available style files')
+    parser.add_argument('--style', type=str, help='Extract specific style by name')
+    parser.add_argument('--all', action='store_true', help='Extract all styles')
+    parser.add_argument('--json', action='store_true', help='Output as JSON')
+    parser.add_argument('--verbose', '-v', action='store_true', help='Verbose output')
+
+    args = parser.parse_args()
+
+    if args.list or (not args.style and not args.all):
+        result = get_style_files()
+    elif args.style:
+        # Find the file with matching name
+        style_files = get_style_files()
+        if 'error' in style_files:
+            result = style_files
+        else:
+            matching = [f for f in style_files['files'] if f['name'] == args.style]
+            if matching:
+                result = extract_style_content(Path(matching[0]['path']), args.verbose)
+            else:
+                result = {'error': f"Style '{args.style}' not found"}
+    elif args.all:
+        style_files = get_style_files()
+        if 'error' in style_files:
+            result = style_files
+        else:
+            result = {
+                'title': 'All Writing Styles',
+                'files': []
+            }
+            for f in style_files['files']:
+                extracted = extract_style_content(Path(f['path']), args.verbose)
+                result['files'].append({'name': f['name'], **extracted})
+    else:
+        result = get_style_files()
+
+    print(format_output(result, args.json))
+
+
+if __name__ == '__main__':
+    main()

package/.opencode/skills/copywriting/templates/copy-brief.md

@@ -0,0 +1,49 @@
+# Copy Brief Template
+
+## Project Info
+
+| Field | Value |
+|-------|-------|
+| Project | |
+| Deliverable | |
+| Due Date | |
+| Writer | |
+
+## Audience
+
+**Who:**
+**Pain points:**
+**Goals:**
+**Awareness level:** (Unaware / Problem-aware / Solution-aware / Product-aware)
+
+## Copy Details
+
+**Type:** (headline / email / landing page / ad / social)
+**Tone:** (professional / casual / urgent / playful)
+**Length:**
+**Primary CTA:**
+
+## Key Messages
+
+1.
+2.
+3.
+
+## Proof Points
+
+-
+-
+
+## Constraints
+
+- Must include:
+- Must avoid:
+- Brand voice notes:
+
+## Formula to Use
+
+[ ] AIDA  [ ] PAS  [ ] BAB  [ ] 4Ps  [ ] FAB
+
+## Success Metrics
+
+-

package/.opencode/skills/creativity/SKILL.md

@@ -0,0 +1,189 @@
+---
+name: ckm:creativity
+description: "Creative direction intelligence. 55 styles, 18 platforms, 12 voiceover types, 17 music genres, 30 campaign categories. Actions: create, design, plan, direct, brief creative campaigns. Projects: ads, videos, social content, commercials, brand films. Styles: minimalist, maximalist, nostalgic, cinematic, UGC, luxury, futuristic, emotional. Topics: visual style, platform specs, voiceover, music, color palette, audience targeting."
+argument-hint: "[style or medium]"
+metadata:
+  author: claudekit
+  version: "2.0.0"
+---
+
+# Creativity Pro Max - Creative Direction Intelligence
+
+Comprehensive creative direction guide for digital marketing campaigns. Contains 55 styles, 18 platforms, 12 voiceover types, 17 music genres, and 30 campaign category recommendations. Searchable database with priority-based recommendations.
+
+## When to Apply
+
+Reference these guidelines when:
+- Planning creative campaigns for any channel
+- Selecting visual styles for ads/content
+- Choosing voiceover/music direction
+- Creating platform-specific content
+- Developing creative briefs
+
+## Core Principle
+
+**92% prefer authentic content over polished ads.** Prioritize real, relatable content over perfection.
+
+## Quick Style Selection
+
+| Audience/Goal | Recommended Styles |
+|---------------|-------------------|
+| Premium/Luxury | Minimalist Clean, Quiet Luxury, Dark Moody Cinematic |
+| Tech/SaaS | Futuristic Sci-Fi, Gradient Smooth, Minimalist Tech |
+| Youth/Gen Z | Raw Unpolished, Humor Comedic, Nostalgic 90s, Neon Cyber |
+| Wellness/Organic | Earthy Organic, Emotional Storytelling, Pastel Soft |
+| B2B/Finance | Authoritative Expert, Data Visualization, Corporate Modern |
+| Community | Authentic UGC, Conversational Casual, Behind The Scenes |
+
+---
+
+## How to Use This Skill
+
+When user requests creative direction (campaign, ad, video, content), follow this workflow:
+
+### Step 1: Analyze User Requirements
+
+Extract key information from user request:
+- **Campaign type**: Product launch, brand awareness, lead gen, etc.
+- **Audience**: Gen Z, Millennials, B2B, etc.
+- **Industry**: SaaS, e-commerce, healthcare, etc.
+- **Platform**: TikTok, Instagram, YouTube, etc.
+
+### Step 2: Generate Creative Brief (REQUIRED)
+
+**Always start with `--creative-brief`** to get comprehensive recommendations:
+
+```bash
+python3 .opencode/skills/creativity/scripts/search.py "<campaign_type> <audience> <industry>" --creative-brief [-c "Campaign Name"]
+```
+
+This command:
+1. Searches 5 domains in parallel (style, platform, voiceover, music, reasoning)
+2. Applies reasoning rules from `creative-reasoning.csv` to select best matches
+3. Returns complete brief: style, platform specs, voiceover, music, effects
+4. Includes anti-patterns to avoid
+
+**Example:**
+```bash
+python3 .opencode/skills/creativity/scripts/search.py "SaaS product launch gen z" --creative-brief -c "App Launch Campaign"
+```
+
+### Step 3: Supplement with Detailed Searches (as needed)
+
+After getting the creative brief, use domain searches for additional details:
+
+```bash
+python3 .opencode/skills/creativity/scripts/search.py "<keyword>" --domain <domain> [-n <max_results>]
+```
+
+**When to use detailed searches:**
+
+| Need | Domain | Example |
+|------|--------|---------|
+| More style options | `style` | `--domain style "minimalist luxury"` |
+| Platform specs | `platform` | `--domain platform "tiktok reels"` |
+| Voiceover direction | `voiceover` | `--domain voiceover "authoritative expert"` |
+| Music recommendations | `music` | `--domain music "ambient electronic"` |
+| Campaign guidance | `reasoning` | `--domain reasoning "e-commerce conversion"` |
+
+### Step 4: Load Reference Details (as needed)
+
+For detailed implementation, load relevant references:
+
+| Reference | Content | Use When |
+|-----------|---------|----------|
+| [creative-styles-part1.md](references/creative-styles-part1.md) | Styles 1-25 with keywords, colors, effects | Selecting visual direction |
+| [creative-styles-part2.md](references/creative-styles-part2.md) | Styles 26-55 with keywords, colors, effects | Selecting visual direction |
+| [color-psychology.md](references/color-psychology.md) | Color meanings, combinations, applications | Choosing color palette |
+| [voiceover-styles.md](references/voiceover-styles.md) | 5 VO categories with delivery specs | Video/audio content |
+| [audio-music.md](references/audio-music.md) | Music trends, sonic branding | Video content, ads |
+| [visual-trends.md](references/visual-trends.md) | 2025-26 design trends | Modern visual direction |
+
+---
+
+## Search Reference
+
+### Available Domains
+
+| Domain | Use For | Example Keywords |
+|--------|---------|------------------|
+| `style` | Visual aesthetics | minimalist, ugc, cinematic, retro, luxury |
+| `platform` | Channel specs | tiktok, instagram, youtube, linkedin |
+| `voiceover` | VO direction | conversational, authoritative, playful |
+| `music` | Audio direction | ambient, upbeat, orchestral, trending |
+| `reasoning` | Campaign strategy | product launch, brand awareness, gen z |
+
+---
+
+## Example Workflow
+
+**User request:** "Create a TikTok campaign for Gen Z SaaS product launch"
+
+### Step 1: Analyze Requirements
+- Campaign type: Product launch
+- Audience: Gen Z
+- Industry: SaaS
+- Platform: TikTok
+
+### Step 2: Generate Creative Brief (REQUIRED)
+
+```bash
+python3 .opencode/skills/creativity/scripts/search.py "gen z saas product tiktok" --creative-brief -c "SaaS Launch"
+```
+
+### Step 3: Supplement with Detailed Searches (as needed)
+
+```bash
+# Get TikTok-specific guidelines
+python3 .opencode/skills/creativity/scripts/search.py "tiktok" --domain platform
+
+# Get Gen Z style options
+python3 .opencode/skills/creativity/scripts/search.py "gen z authentic raw" --domain style
+```
+
+---
+
+## Output Formats
+
+```bash
+# ASCII box (default) - best for terminal display
+python3 .opencode/skills/creativity/scripts/search.py "e-commerce launch" --creative-brief
+
+# Markdown - best for documentation
+python3 .opencode/skills/creativity/scripts/search.py "e-commerce launch" --creative-brief -f markdown
+```
+
+---
+
+## Key Stats
+
+- Humor increases recall 33% (only 33% of ads use it)
+- Color drives 85% purchase decisions
+- Brand recognition +80% with consistent colors
+- UGC: 28% higher engagement, 4x CTR, 50% lower CPA
+
+---
+
+## Platform Quick Specs
+
+| Platform | Ratio | Length | Hook | Style Note |
+|----------|-------|--------|------|------------|
+| TikTok | 9:16 | 15-60s | 3s | Raw, trending sounds |
+| Instagram Reels | 9:16 | 15-90s | 3s | Polished-authentic |
+| YouTube | 16:9 | 30s-10m | 30s | High production |
+| LinkedIn | 1:1, 4:5 | 30s-2m | 5s | Professional, value-first |
+| Stories | 9:16 | 15s | 1s | Immediate hook, swipe CTA |
+
+---
+
+## Pre-Production Checklist
+
+- [ ] Brand guidelines reviewed
+- [ ] Audience persona confirmed
+- [ ] Creative style approved from search results
+- [ ] Platform specs verified
+- [ ] Success metrics defined
+- [ ] Hook in first 3 seconds
+- [ ] Sound-off optimized (captions)
+- [ ] Mobile-first designed
+- [ ] A/B test variables identified

package/.opencode/skills/creativity/data/creative-reasoning.csv

@@ -0,0 +1,31 @@
+No,Category,Style_Priority,Color_Mood,Music_Mood,VO_Style,Key_Effects,Platform_Priority,Audience_Age,Decision_Rules,Anti_Patterns,Severity
+1,SaaS Product Launch,"Gradient Smooth + Minimalist Tech",Tech blue + Clean accent,Ambient electronic + Building,Modern clean confident,"Smooth transitions, interface demos, feature reveals","YouTube Long, LinkedIn, Twitter/X","25-54 professionals","{""if_demo_heavy"": ""add-screen-recordings"", ""if_b2b"": ""emphasize-roi""}","Overly playful, UGC style, loud music",HIGH
+2,Consumer Product Launch,"Lifestyle Aspirational + Bright Cheerful",Vibrant brand + Warm,Upbeat pop + Trending,Energetic friendly,"Product reveals, lifestyle shots, unboxing","Instagram, TikTok, YouTube","18-44 consumers","{""if_premium"": ""switch-to-quiet-luxury"", ""if_gen_z"": ""add-ugc-elements""}","Corporate tone, dark moody, slow pacing",HIGH
+3,Brand Awareness,"Emotional Storytelling + Cinematic Documentary",Brand colors + Emotional warmth,Orchestral + Building emotional,Warm genuine inspiring,"Narrative arc, real people, emotional beats","YouTube Long, TV/OTT, Facebook","Broad 25-54","{""if_cause_driven"": ""increase-authenticity"", ""if_premium"": ""cinematic-quality""}","Sales focus, product-heavy, hard CTA",HIGH
+4,Lead Generation,"Authoritative Expert + Data Visualization",Trust blue + Professional,Corporate subtle + Confident,Professional measured expert,"Data graphics, expert quotes, proof points","LinkedIn, YouTube, Email","B2B decision makers 30-54","{""must_have"": ""clear-value-prop"", ""if_complex"": ""simplify-message""}","Playful tone, trendy music, casual style",HIGH
+5,E-commerce Conversion,"Bold Color Clash + Bright Cheerful",Vibrant + Urgency orange,Upbeat energetic,Friendly urgent persuasive,"Product close-ups, social proof, urgency","Instagram, TikTok, Facebook","Shoppers 18-44","{""if_luxury"": ""switch-to-quiet-luxury"", ""if_flash_sale"": ""add-urgency""}","Slow reveals, complex messaging, no CTA",HIGH
+6,Community Building,"Authentic UGC + Behind The Scenes",Warm authentic + Brand accent,Lo-fi beats + Trending sounds,Conversational genuine,"Real customers, BTS content, user stories","TikTok, Instagram, Facebook Groups","Community members, engaged fans","{""must_have"": ""real-people"", ""if_testimonial"": ""let-users-speak""}","Polished corporate, scripted, actor-heavy",HIGH
+7,Thought Leadership,"Authoritative Expert + Corporate Modern",Navy + Gold accents,Subtle orchestral + Confident,Expert authoritative measured,"Data overlays, expert interviews, insights","LinkedIn, YouTube, Podcast","Executives, professionals 35-60","{""must_have"": ""credentials-visible"", ""if_data_heavy"": ""visualize-stats""}","Trendy music, casual tone, Gen Z style",HIGH
+8,Recruitment/Employer Brand,"Behind The Scenes + Lifestyle Aspirational",Brand colors + Warm,Upbeat positive + Authentic,Friendly warm genuine,"Team footage, culture shots, real employees","LinkedIn, Instagram, YouTube","Job seekers 22-40","{""must_have"": ""real-employees"", ""if_tech"": ""show-workspace""}","Stock footage, scripted, overly corporate",MEDIUM
+9,Gen Z Campaign,"Raw Unpolished + Nostalgic 90s",Neon + Trending colors,Trending sounds + Lo-fi,Casual authentic relatable,"Jump cuts, memes, trends, unpolished","TikTok, Instagram Reels, Snapchat","Gen Z 16-25","{""must_have"": ""platform-native"", ""if_brand"": ""subtly-integrate""}","Corporate polish, scripted, old trends",HIGH
+10,Millennial Campaign,"Conversational Casual + Lifestyle Aspirational",Warm + Aspirational,Indie acoustic + Chill pop,Friendly warm relatable,"Lifestyle shots, humor, authenticity","Instagram, YouTube, TikTok","Millennials 26-40","{""if_nostalgia"": ""add-90s-elements"", ""if_values"": ""show-authenticity""}","Too corporate, too Gen Z, inauthentic",MEDIUM
+11,Gen X/Boomer Campaign,"Emotional Storytelling + Cinematic Documentary",Warm traditional + Trust,Classic rock + Orchestral,Trustworthy warm experienced,"High production, storytelling, family","Facebook, YouTube, TV","Gen X/Boomers 45+","{""must_have"": ""clear-audio"", ""if_tech"": ""simplify-ui""}","TikTok trends, slang, low production",MEDIUM
+12,Healthcare,"Emotional Storytelling + Pastel Soft",Calm blue + Health green,Gentle piano + Reassuring,Warm reassuring professional,"Real patients, gentle transitions, trust","YouTube, Facebook, TV","Patients, caregivers 35+","{""must_have"": ""compliance-reviewed"", ""must_have"": ""accessible""}","Bright neon, fast cuts, trendy music",HIGH
+13,Finance/Banking,"Authoritative Expert + Minimalist Clean",Navy + Gold + Trust blue,Subtle confident + Professional,Professional trustworthy confident,"Clean graphics, security indicators, data","YouTube, LinkedIn, TV","Adults 30+, professionals","{""must_have"": ""compliance-approved"", ""must_have"": ""trust-signals""}","Playful, trendy, UGC style, casual",HIGH
+14,Food & Beverage,"Macro Close-Up + Bright Cheerful",Warm appetizing + Product colors,Upbeat + Satisfying,Friendly appetizing enthusiastic,"Close-ups, satisfying shots, appetite appeal","Instagram, TikTok, TV","Food lovers, broad 18-54","{""must_have"": ""high-quality-food-shots"", ""if_recipe"": ""show-process""}","Unappetizing lighting, fast cuts, no food beauty",HIGH
+15,Fashion & Beauty,"Minimalist Clean + Lifestyle Aspirational",Brand + Skin-flattering,Stylish + Trending,Sophisticated aspirational,"Model shots, texture details, lifestyle","Instagram, TikTok, Pinterest","Fashion-forward 18-44","{""if_luxury"": ""quiet-luxury"", ""if_trendy"": ""add-ugc""}","Unflattering lighting, low quality, over-retouched",HIGH
+16,Gaming,"Cyberpunk Digital + Retro-Futurism",Neon + Dark backgrounds,Electronic + Epic,Energetic edgy exciting,"Gameplay, epic moments, hype build","YouTube, TikTok, Twitch","Gamers 16-34","{""must_have"": ""gameplay-footage"", ""if_competitive"": ""show-skill""}","Corporate, slow, non-gaming aesthetic",HIGH
+17,Travel & Tourism,"Cinematic Documentary + Drone Aerial",Destination colors + Inspiring,Epic orchestral + Inspiring,Inspiring warm adventurous,"Drone shots, immersive scenery, experiences","YouTube, Instagram, Pinterest","Travelers 25-54","{""must_have"": ""stunning-visuals"", ""if_adventure"": ""action-shots""}","Stock footage feeling, generic, indoor-heavy",HIGH
+18,Real Estate,"Drone Aerial + Cinematic Documentary",Clean + Luxe neutrals,Elegant + Aspirational,Professional confident welcoming,"Drone tours, interior reveals, neighborhood","YouTube, Facebook, Zillow","Buyers/sellers 30-60","{""must_have"": ""quality-property-shots"", ""if_luxury"": ""premium-production""}","Poor photography, shaky video, no staging",HIGH
+19,Automotive,"Cinematic Documentary + Slow Motion",Brand + Metallic,Epic + Engine sounds,Confident powerful aspirational,"Car reveals, performance shots, lifestyle","YouTube, TV, Instagram","Buyers 25-54","{""must_have"": ""hero-car-shots"", ""if_performance"": ""action-footage""}","Static shots, poor lighting, no emotion",HIGH
+20,Non-Profit/Cause,"Emotional Storytelling + Authentic UGC",Warm hopeful + Cause colors,Emotional piano + Building,Genuine emotional heartfelt,"Real stories, impact footage, hope","YouTube, Facebook, TV","Donors, advocates 35+","{""must_have"": ""real-beneficiaries"", ""must_have"": ""clear-impact""}","Guilt-heavy, graphic, hopeless tone",HIGH
+21,Sports & Fitness,"Inspirational Motivational + Slow Motion",Energetic + Achievement gold,Anthemic + Pump-up,Powerful motivating inspiring,"Action shots, transformation, achievement","YouTube, Instagram, TikTok","Athletes, fitness 18-44","{""must_have"": ""action-footage"", ""if_transformation"": ""before-after""}","Static, no energy, overly commercial",HIGH
+22,Technology/Startup,"Futuristic Sci-Fi + Gradient Smooth",Tech blue + Innovation accent,Ambient electronic + Building,Modern confident innovative,"Product demos, interface shots, innovation","YouTube, LinkedIn, Product Hunt","Tech enthusiasts, investors 25-44","{""if_demo"": ""show-working-product"", ""if_b2b"": ""roi-focus""}","Outdated aesthetic, corporate boring, no demo",HIGH
+23,Education/EdTech,"Clean Infographic + Conversational Casual",Friendly + Educational colors,Gentle + Encouraging,Friendly encouraging clear,"Animations, diagrams, student success","YouTube, Instagram, TikTok","Students, parents, educators 18-50","{""must_have"": ""clear-explanation"", ""if_kids"": ""playful-elements""}","Boring, overly complex, no engagement",MEDIUM
+24,Luxury Goods,"Quiet Luxury + Dark Moody Cinematic",Muted neutrals + Gold,Classical + Elegant,Refined sophisticated hushed,"Texture details, craftsmanship, exclusivity","YouTube, Instagram, Pinterest","Affluent 30-60","{""must_have"": ""premium-production"", ""must_have"": ""material-focus""}","Bright, loud, mass-market feel, UGC",HIGH
+25,Entertainment/Media,"Maximalist Bold + Festival Vibrant",Vibrant neon + Dynamic,Trending + High energy,Energetic exciting playful,"Hype cuts, star moments, excitement","YouTube, TikTok, Instagram","Entertainment fans 16-44","{""if_movie"": ""cinematic-trailer"", ""if_music"": ""artist-focus""}","Boring, slow, corporate, no excitement",HIGH
+26,Event Promotion,"Festival Vibrant + Time Lapse",Event colors + Energy,Building + Hype,Exciting energetic urgent,"Countdown, highlights, FOMO content","Instagram, TikTok, Facebook Events","Event-goers 18-44","{""must_have"": ""date-visible"", ""must_have"": ""clear-cta""}","No urgency, vague details, boring",HIGH
+27,Sustainability/Eco,"Earthy Organic + Nature Inspired",Earth tones + Green,Acoustic + Nature sounds,Genuine warm authentic,"Nature footage, process, impact","Instagram, YouTube, Pinterest","Eco-conscious 25-44","{""must_have"": ""authenticity"", ""must_have"": ""proof-not-claims""}","Greenwashing, corporate, inauthentic",HIGH
+28,Pet Products,"Bright Cheerful + Authentic UGC",Warm + Playful,Upbeat playful,Friendly warm loving,"Pet footage, owner testimonials, cute moments","TikTok, Instagram, Facebook","Pet owners 25-54","{""must_have"": ""real-pets"", ""if_funny"": ""embrace-humor""}","Stock pets, overly serious, no pets visible",MEDIUM
+29,Subscription Service,"Split Screen + Data Visualization",Brand + Value accent,Modern + Confident,Clear friendly persuasive,"Before/after, value comparison, features","YouTube, Instagram, Display","Target subscribers 25-44","{""must_have"": ""clear-value-prop"", ""if_free_trial"": ""low-risk-cta""}","Complex pricing, hidden value, confusing",HIGH
+30,Local Business,"Conversational Casual + Behind The Scenes",Warm local + Brand,Friendly local + Acoustic,Friendly warm local,"Owner story, local connection, community","Facebook, Instagram, Google","Local customers 30+","{""must_have"": ""local-authenticity"", ""if_service"": ""show-results""}","Generic, stock footage, no local feel",MEDIUM

package/.opencode/skills/creativity/data/music.csv

@@ -0,0 +1,18 @@
+Genre,Mood,BPM_Range,Instruments,Best_For,Styles_Match,Avoid_For,Licensing_Notes
+Ambient Electronic,"Calm, modern, tech-forward","60-90","Synth pads, soft beats, atmospheric","SaaS, tech, modern brands, tutorials","Minimalist Clean, Gradient Smooth, Futuristic Sci-Fi, Minimalist Tech","Energetic campaigns, youth, entertainment","Royalty-free widely available"
+Upbeat Pop,"Happy, energetic, positive","110-130","Synths, drums, bass, vocals or instrumental","Consumer goods, lifestyle, bright campaigns","Bright Cheerful, Maximalist Bold, Festival Vibrant","B2B, serious topics, luxury","Sync licensing required for major tracks"
+Indie Acoustic,"Warm, authentic, friendly","80-110","Acoustic guitar, soft percussion, piano","Lifestyle, community, authentic brands","Conversational Casual, Earthy Organic, Emotional Storytelling","Tech, gaming, corporate","Many royalty-free options"
+Orchestral Cinematic,"Epic, dramatic, emotional","Varies","Orchestra, strings, brass, percussion","Premium brands, film, sports, causes","Cinematic Documentary, Inspirational Motivational, Emotional Storytelling","Casual content, quick social","Composer licensing or library"
+Lo-fi Beats,"Chill, relaxed, modern","70-90","Sampled beats, vinyl crackle, mellow keys","Gen Z, coffee brands, study content, TikTok","Raw Unpolished, Authentic UGC, Conversational Casual","Corporate, formal, high-energy","Many royalty-free, creator-friendly"
+Electronic Dance,"High energy, exciting, modern","120-150","Synths, heavy bass, electronic drums","Events, gaming, youth brands, parties","Neon Cyber, Festival Vibrant, Maximalist Bold","Luxury, B2B, healthcare, serious","DJ mix considerations, sync rights"
+Classical,"Elegant, timeless, sophisticated","Varies","Orchestra, piano, strings","Luxury, heritage, high-end, refined","Quiet Luxury, Metallic Luxe, Monochromatic","Youth, gaming, fast-paced","Public domain older works, sync for modern"
+Jazz,"Sophisticated, cool, premium","80-120","Brass, piano, bass, drums","Premium, restaurants, nightlife, cocktails","Quiet Luxury, Retro-Futurism, Metallic Luxe","Youth, tech, fast-paced","Classic jazz may be public domain"
+Synthwave,"Nostalgic, 80s, retro-futuristic","100-120","Vintage synths, drum machines, arpeggios","Retro campaigns, gaming, Gen X/Millennial nostalgia","Nostalgic 80s, Retro-Futurism, Neon Cyber","Traditional, conservative, elderly","Growing royalty-free library"
+Corporate Subtle,"Professional, neutral, unobtrusive","80-100","Light synths, soft piano, minimal","B2B, corporate, professional services","Corporate Modern, Authoritative Expert, Data Visualization","Entertainment, youth, emotional","Abundant royalty-free options"
+Trending Sounds,"Platform-native, viral, current","Varies","Whatever is trending","TikTok, Reels, social content","Raw Unpolished, Authentic UGC, Humor Comedic","Brand campaigns needing longevity, TV","Platform licensing, short-lived relevance"
+Hip-Hop/Urban,"Street, authentic, energetic","80-110","808s, hi-hats, bass, samples","Streetwear, urban brands, sneakers","Urban Street, Bold Color Clash, Maximalist Bold","Corporate, traditional, conservative","Artist licensing complex, instrumental easier"
+Nature/Ambient,"Peaceful, organic, calming","N/A or 60-80","Nature sounds, soft pads, minimal","Wellness, eco-brands, outdoor, spa","Earthy Organic, Nature Inspired, Pastel Soft","Urban, tech, high-energy","Many royalty-free nature sounds"
+Anthemic Rock,"Powerful, triumphant, motivating","120-140","Electric guitars, drums, bass","Sports, achievements, launches","Inspirational Motivational, Bold Color Clash","Luxury, calm, B2B, healthcare","Major artist sync expensive"
+Quirky/Playful,"Fun, unexpected, humorous","100-130","Unusual instruments, pizzicato, whistling","Humor, creative, children, playful","Humor Comedic, Claymorphism, Pop Art","Serious, B2B, luxury, formal","Good royalty-free availability"
+Dark Electronic,"Edgy, intense, moody","90-130","Dark synths, industrial beats, bass","Gaming, tech, edgy brands, thriller","Cyberpunk Digital, Dark Moody Cinematic, Provocative Edgy","Family, wellness, bright brands","Royalty-free available"
+World/Fusion,"Cultural, diverse, global","Varies","Cultural instruments, fusion styles","Travel, global brands, multicultural","Travel campaigns, international brands","Stereotyping risk, local vs global","Cultural sensitivity required"

package/.opencode/skills/creativity/data/platforms.csv

@@ -0,0 +1,19 @@
+Platform,Ratio,Length_Short,Length_Long,Hook_Time,Style_Notes,Audio,Best_Styles,Content_Types,Audience,Avoid
+TikTok,9:16,15s,60s,3s,"Raw authentic preferred, trending sounds, captions required","Trending sounds, popular music, voiceover","Raw Unpolished, Authentic UGC, Humor Comedic, Nostalgic 90s, Bold Color Clash","Challenges, tutorials, behind-scenes, reactions, trends","Gen Z, Millennials, 18-34","Overly polished, corporate, long intros"
+Instagram Reels,9:16,15s,90s,3s,"Polished-authentic hybrid, music-driven, aesthetic focus","Trending audio, original audio, music","Minimalist Clean, Pastel Soft, Gradient Smooth, Lifestyle Aspirational, Authentic UGC","Tutorials, reveals, aesthetic content, product showcases","Millennials, Gen Z, 18-44","Text-heavy, corporate, no visual hook"
+Instagram Stories,9:16,5s,15s,1s,"Immediate hook, swipe CTA, ephemeral feel, interactive elements","Music, voiceover, sounds","Bright Cheerful, Authentic UGC, Behind The Scenes, Raw Unpolished","Polls, questions, quick updates, flash sales","Existing followers, engaged audience","Long content, complex messages, no CTA"
+Instagram Feed,1:1 4:5,10s,60s,3s,"High quality, curated aesthetic, brand consistency","Optional, often silent-optimized","Minimalist Clean, Quiet Luxury, Lifestyle Aspirational, Monochromatic","Product photos, carousels, branded content","Millennials, 25-44","Low quality, inconsistent aesthetic"
+YouTube Shorts,9:16,15s,60s,3s,"Thumbnail optional, loop-friendly, satisfying content","Music, voiceover, ASMR","Cinematic Documentary, Humor Comedic, Emotional Storytelling, Behind The Scenes","Tutorials, facts, entertainment, reactions","Broad, all ages","Long intros, no payoff, clickbait"
+YouTube Long,16:9,30s,10m+,30s,"Story arc, high production, chapter markers, detailed content","Full audio production, music, voiceover","Cinematic Documentary, Emotional Storytelling, Authoritative Expert, Inspirational Motivational","Tutorials, vlogs, documentaries, reviews","Broad, intent-driven, 18-54","Clickbait, poor audio, no value delivery"
+LinkedIn,1:1 4:5,30s,2m,5s,"Professional value-first, educational, thought leadership","Professional voiceover, subtle music","Authoritative Expert, Corporate Modern, Data Visualization, Clean Infographic","Thought leadership, case studies, tips, industry insights","Professionals, B2B, 25-54","Casual, trendy, sales-heavy, memes"
+LinkedIn Native Video,16:9 1:1,30s,10m,5s,"Captions required, professional quality, educational focus","Clear voiceover, minimal music","Authoritative Expert, Inspirational Motivational, Corporate Modern","Interviews, expert tips, company culture, announcements","Decision makers, professionals","Poor audio, no captions, hard sell"
+Twitter/X,16:9 1:1,15s,2m20s,3s,"Quick takes, conversation starters, news-jacking","Music optional, captions required","Minimalist Tech, Humor Comedic, Data Visualization, Kinetic Typography","Hot takes, threads, announcements, reactions","News consumers, tech, 25-54","Long form, polished ads, promotional"
+Facebook,16:9 1:1 4:5,15s,3m,5s,"Captions essential, shareable, emotional resonance","Music, voiceover","Emotional Storytelling, Bright Cheerful, Authentic UGC, Family content","Shareable content, local, community, how-to","35+, families, broad","Gen Z trends, edgy content, niche"
+Facebook Reels,9:16,15s,90s,3s,"Similar to IG Reels, slightly older demographic","Trending sounds, music","Bright Cheerful, Humor Comedic, Behind The Scenes","Entertainment, relatable content, how-to","30+, broader than TikTok","Gen Z specific, niche subcultures"
+Pinterest,2:3 1:1,6s,60s,2s,"Inspirational, searchable, save-worthy, aesthetic","Subtle music, often silent","Lifestyle Aspirational, Earthy Organic, Pastel Soft, Minimalist Clean","How-to, inspiration, product pins, ideas","Women 25-44, planners","Ugly visuals, clickbait, non-visual"
+Snapchat,9:16,3s,10s,1s,"Immediate, raw, AR features, disappearing","Native sounds, effects","Raw Unpolished, Neon Cyber, Festival Vibrant, Authentic UGC","Filters, quick promos, flash content","Gen Z, 13-24","Polished, long content, corporate"
+TV/OTT,16:9,15s,60s,5s,"High production, sound-on designed, broadcast quality","Full audio production, music","Cinematic Documentary, Inspirational Motivational, Emotional Storytelling","Brand films, commercials, sponsorships","Broad, mass market","Lo-fi, user-generated, niche"
+Podcast Ads,Audio,15s,60s,N/A,"Host-read preferred, conversational, integrated","Voice only, minimal music","Conversational Casual, Authoritative Expert, Humor Comedic","Mid-roll, pre-roll, host endorsements","Podcast listeners, niche audiences","Hard sell, complex CTAs, poor audio"
+Digital Display,Various,5s,15s,0s,"Eye-catching, simple message, clear CTA, animated GIF/HTML5","Silent, music optional","Minimalist Tech, Bold Color Clash, Gradient Smooth, Kinetic Typography","Banners, interstitials, native ads","Varies by placement","Complex, too much text, slow loading"
+CTV/Streaming,16:9,6s,30s,3s,"Non-skippable aware, high quality, sound-on","Full production audio","Cinematic Documentary, Bright Cheerful, Emotional Storytelling","Pre-roll, mid-roll, sponsored content","Streaming viewers, cord-cutters","Low quality, boring first 6s"
+Email,Various,GIF 3s,Video 30s,1s,"Preview-friendly, accessible, fallback image","Optional, often silent","Minimalist Clean, Kinetic Typography, Clean Infographic","Announcements, tutorials, product features","Email subscribers","Auto-play audio, heavy files, no fallback"