name: brand-research-agent
description: >
Use this skill to analyze a brand from their website before creating content.
Triggers: "analyze brand", "research brand", "brand guidelines", "brand profile",
"understand brand", "brand colors", "brand voice", "before creating content for"
Extracts: colors, typography, voice/tone, products, audience, competitive positioning.
Outputs a reusable brand_profile.json that producer skills can use.

Brand Research Skill

Analyze a brand's website to extract brand elements for content creation.

This skill uses 5 specialized agents that analyze different brand dimensions in parallel, then synthesizes into a unified brand profile.

What It Extracts

Prerequisites

• Browser access (uses web scraping)
• No API keys required

Workflow

Step 1: Get the Website URL (REQUIRED)

FIRST, always ask for the website URL. Do not proceed without it.

Say this to the user:

"I'll analyze that brand for you!

What's the website URL? (e.g., https://nike.com)

Optional: Any specific pages to focus on? Any known competitors?"

Wait for the user to provide the URL before proceeding.

If the user just says "analyze Nike's brand", ask:

"I'll analyze Nike for you. Just to confirm - should I use https://nike.com?"

Step 2: Navigate and Capture Website Data

Use browser tools to navigate the website and capture:

1. Homepage - Overall impression, hero messaging, colors
2. About page - Company story, values, team
3. Products/Services page - Offerings, features, pricing
4. Blog/Resources - Voice, content style
5. Footer - Social links, taglines

Capture for each page:
- Screenshot for visual analysis
- HTML/CSS for colors and fonts
- Text content for voice analysis
- Images for style analysis

Step 3: Run Specialized Agents in Parallel

Deploy 5 agents, each analyzing a different dimension:

Agent 1: Visual Analyst

Focus: Colors, typography, logo, imagery style

Analyze:
- Primary, secondary, accent colors from CSS/design
- Font families for headings and body
- Logo usage and placement
- Photography/illustration style
- Overall visual mood (minimal, bold, playful, etc.)

Agent 2: Voice Analyst

Focus: Tone, messaging, taglines, copy style

Analyze:
- Headlines and how they're written
- Body copy style (formal vs casual)
- CTAs and their tone
- Taglines and slogans
- Emotional appeals used

Agent 3: Product Analyst

Focus: Offerings, features, USPs, pricing

Analyze:
- What products/services they offer
- Key features highlighted
- Unique selling propositions
- Pricing model and tiers
- Value propositions

Agent 4: Audience Analyst

Focus: Demographics, psychographics, pain points

Analyze:
- Who the messaging targets
- Pain points addressed
- Aspirations appealed to
- Language level and jargon
- Testimonials and case studies

Agent 5: Competitive Analyst

Focus: Market position, competitors, differentiation

Analyze:
- Market/industry category
- Implied competitors
- How they differentiate
- Unique market position
- Competitive advantages claimed

Step 4: Synthesize into Brand Profile

Combine all agent outputs into a unified brand_profile.json:

{
  "brand": {
    "name": "Company Name",
    "website": "https://example.com",
    "tagline": "Their main tagline",
    "analyzed_date": "2026-01-04"
  },
  "visual": {
    "colors": {
      "primary": "#1E40AF",
      "secondary": "#F59E0B",
      "accent": "#10B981",
      "background": "#FFFFFF",
      "text": "#1F2937"
    },
    "typography": {
      "headings": "Montserrat Bold",
      "body": "Open Sans",
      "style": "Modern, clean"
    },
    "logo": {
      "description": "Abstract geometric mark + wordmark",
      "usage": "Typically on white/dark backgrounds"
    },
    "imagery_style": {
      "type": "Photography",
      "mood": "Professional, aspirational",
      "subjects": "People using product, office settings",
      "treatment": "Bright, high contrast, natural lighting"
    }
  },
  "voice": {
    "tone": ["Confident", "Approachable", "Expert"],
    "personality": "Like a smart friend who knows their stuff",
    "formality": "Professional casual",
    "style_notes": [
      "Short, punchy sentences",
      "Active voice preferred",
      "Benefit-focused over feature-focused",
      "Uses 'you' and 'your' frequently"
    ],
    "example_headlines": [
      "Built for builders",
      "Simple. Powerful. Yours."
    ],
    "words_to_use": ["Simple", "Powerful", "Fast", "Seamless"],
    "words_to_avoid": ["Cheap", "Basic", "Just"]
  },
  "products": {
    "category": "SaaS / Developer Tools",
    "offerings": [
      {
        "name": "Core Platform",
        "description": "Main product offering",
        "key_features": ["Feature 1", "Feature 2", "Feature 3"]
      }
    ],
    "usps": [
      "10x faster than alternatives",
      "No-code setup in 5 minutes",
      "Enterprise-grade security"
    ],
    "pricing_model": "Freemium with usage-based scaling",
    "value_proposition": "Get to market faster without sacrificing quality"
  },
  "audience": {
    "primary": {
      "who": "Technical founders and developers",
      "demographics": "25-45, tech-savvy, startup/scale-up",
      "psychographics": "Move fast, value efficiency, quality-conscious"
    },
    "secondary": {
      "who": "Enterprise DevOps teams",
      "demographics": "Large companies, IT departments"
    },
    "pain_points": [
      "Complex setup processes",
      "Slow iteration cycles",
      "Scaling costs out of control"
    ],
    "aspirations": [
      "Ship faster",
      "Look professional",
      "Scale effortlessly"
    ]
  },
  "positioning": {
    "market": "Developer tools / Infrastructure",
    "competitors": ["Competitor A", "Competitor B", "Competitor C"],
    "differentiation": "Simplicity + Enterprise power in one package",
    "market_position": "Premium but accessible",
    "competitive_advantages": [
      "Easiest setup in category",
      "Best-in-class performance",
      "Loved by developers"
    ]
  },
  "content_guidelines": {
    "for_video_producer": {
      "music_style": "Modern, upbeat, confident but not aggressive",
      "voiceover_tone": "Confident, clear, approachable expert",
      "visual_style": "Clean, minimal, bold accents, professional"
    },
    "for_podcast_producer": {
      "host_personality": "Smart, curious, enthusiastic about tech",
      "conversation_style": "Educational but engaging, not dry"
    },
    "for_audio_producer": {
      "voiceover_direction": "Professional but warm, not corporate robot",
      "music_mood": "Inspiring, forward-moving, modern"
    },
    "for_social_producer": {
      "image_style": "Clean product shots, lifestyle use cases",
      "video_style": "Quick, punchy, value-first",
      "copy_style": "Short, benefit-focused, emoji-light"
    }
  }
}

Step 5: Save and Deliver

Save the brand profile:

# Save to current directory
brand_profile.json

# Or to a specific location
/path/to/project/brand_profile.json

Delivery message:

"✅ Brand analysis complete!

Brand Profile saved to: brand_profile.json

Summary:
- Brand: Acme Corp
- Colors: Blue (#1E40AF) + Orange (#F59E0B)
- Voice: Confident, approachable, expert
- Audience: Technical founders, 25-45
- Position: Simplicity + Power

Use this profile with:
- video-producer --brand brand_profile.json
- podcast-producer --brand brand_profile.json
- social-producer --brand brand_profile.json

Want me to:
- Analyze additional pages?
- Deep dive on any dimension?
- Create content using this profile?"

Using the Brand Profile with Producers

Once you have a brand_profile.json, reference it when creating content:

Example workflow:

USER: "Create a product video using our brand profile"

PRODUCER:
1. Reads brand_profile.json
2. Uses colors for visual prompts: "Color scheme: blue (#1E40AF) and orange (#F59E0B)"
3. Uses voice for TTS: "Tone: Confident, approachable, professional"
4. Uses music style: "Modern, upbeat, confident"
5. Uses imagery style: "Clean, minimal, professional photography"

RESULT: On-brand video that matches company's existing presence

Manual Brand Profile

If you can't scrape or prefer manual input, create brand_profile.yaml:

brand:
  name: "My Company"
  tagline: "Innovation for everyone"

visual:
  colors:
    primary: "#1E40AF"
    secondary: "#F59E0B"
  typography:
    headings: "Montserrat"
    body: "Open Sans"

voice:
  tone: ["Friendly", "Expert", "Approachable"]
  formality: "Professional casual"

audience:
  primary: "Small business owners, 30-50"
  pain_points: ["Too complex", "Too expensive"]

# ... etc

Agents

This skill uses 5 specialized agents defined in agents/:

Limitations

• Dynamic content: May miss JavaScript-rendered content
• Accuracy: Analysis is interpretation, not definitive
• Access: Some sites may block scraping
• Currency: Brands evolve; re-analyze periodically

Example Prompts

Basic:

"Analyze Nike's brand from their website"

With specifics:

"Research the Apple brand, focusing on their product pages and About section"

For content creation:

"Before creating our marketing video, analyze our competitor's brand: https://competitor.com"

Update existing:

"Re-analyze our brand profile, we've updated our website"