/content-brief-generator

name: content-brief-generator
description: Generate comprehensive content briefs for writers, ensuring clarity, alignment, and strategic content creation across all formats.

Content Brief Generator

A comprehensive skill for creating detailed content briefs that guide writers, ensure consistency, and align content with business goals.

What This Skill Does

Helps you create professional content briefs for:

• **Blog posts and articles** - Thought leadership, tutorials, how-tos
• **Technical documentation** - API docs, guides, README files
• **Marketing copy** - Landing pages, email campaigns, ads
• **Social media content** - Posts, campaigns, threads
• **Case studies** - Customer success stories
• **Whitepapers and reports** - In-depth research content
• **Product descriptions** - E-commerce and product pages
• **Video scripts** - YouTube, explainer videos, demos

Why Content Briefs Matter

**Without a brief:**

• Unclear expectations and scope
• Multiple rounds of revisions
• Inconsistent tone and messaging
• Missing SEO opportunities
• Wasted time and resources

**With a brief:**

• Clear direction and goals
• Fewer revisions needed
• Consistent quality
• SEO-optimized content
• Efficient workflow

Core Components of a Content Brief

1. Content Overview

• Title/working title
• Content type (blog, doc, landing page, etc.)
• Target audience
• Primary goal (educate, convert, entertain, etc.)
• Key message or takeaway

2. Audience & Context

• Target persona
• Reader's knowledge level
• Pain points and needs
• Where they are in the funnel
• How they'll discover content

3. Strategic Elements

• Business objectives
• SEO keywords and intent
• Competitive landscape
• Success metrics
• CTAs and conversion goals

4. Content Requirements

• Tone and voice
• Length/word count
• Structure and sections
• Research requirements
• Visual/media needs

5. SEO & Distribution

• Primary and secondary keywords
• Search intent
• Meta description
• Internal/external links
• Distribution channels

Content Types & Templates

Blog Post Brief

**Use for:** Thought leadership, tutorials, listicles, how-tos

**Key elements:**

• Hook and introduction angle
• Main points (typically 3-7)
• Examples and data to include
• Call-to-action
• Internal linking strategy

Technical Documentation Brief

**Use for:** API docs, guides, developer documentation

**Key elements:**

• Technical accuracy requirements
• Code examples needed
• Audience technical level
• Prerequisites
• Related documentation

Landing Page Brief

**Use for:** Product pages, signup pages, campaign pages

**Key elements:**

• Value proposition
• Benefits vs. features
• Social proof requirements
• Conversion goal
• A/B testing plan

Case Study Brief

**Use for:** Customer success stories, testimonials

**Key elements:**

• Customer background
• Problem/solution/results framework
• Metrics and outcomes
• Quotes needed
• Industry context

Content Structure Frameworks

AIDA (Attention, Interest, Desire, Action)

**Best for:** Marketing copy, sales pages

1. **Attention:** Grab with headline 2. **Interest:** Build with benefits 3. **Desire:** Create want with proof 4. **Action:** Drive with clear CTA

PAS (Problem, Agitate, Solve)

**Best for:** Blog posts, email campaigns

1. **Problem:** Identify pain point 2. **Agitate:** Emphasize urgency 3. **Solve:** Present solution

Inverted Pyramid

**Best for:** News, technical docs

1. Most important info first 2. Supporting details 3. Background context

Storytelling Arc

**Best for:** Case studies, narratives

1. Setup (character/situation) 2. Conflict (challenge) 3. Resolution (solution) 4. Takeaway (lesson)

SEO Integration

Keyword Strategy

• Primary keyword (1)
• Secondary keywords (2-3)
• Long-tail variations (3-5)
• LSI keywords (related terms)

Search Intent

• **Informational:** Learn about something
• **Navigational:** Find specific page
• **Commercial:** Compare options
• **Transactional:** Ready to buy

On-Page SEO

• Title tag (include primary keyword)
• Meta description (compelling + keyword)
• Headers (H1, H2, H3 with keywords)
• Image alt text
• Internal linking

Tone & Voice Guidelines

Tone Spectrum

• **Formal ↔ Casual**
• **Serious ↔ Playful**
• **Respectful ↔ Irreverent**
• **Enthusiastic ↔ Matter-of-fact**

Voice Attributes

Define your brand voice:

• **Professional but approachable** (like Stripe)
• **Technical but friendly** (like Twilio)
• **Playful and bold** (like Mailchimp)
• **Authoritative and trustworthy** (like HubSpot)

Writing Style

• Active vs. passive voice
• Person (1st, 2nd, 3rd)
• Sentence length
• Paragraph structure
• Use of jargon

Research & Sourcing

Research Requirements

• **Primary research:** Interviews, surveys, original data
• **Secondary research:** Industry reports, competitor analysis
• **Expert quotes:** SME interviews, third-party experts
• **Data and statistics:** Credible sources, recent data
• **Examples:** Real-world cases, screenshots

Citation Standards

• Link to original sources
• Attribute quotes
• Recent data (within 1-2 years)
• Authoritative sources
• Fact-checking requirements

Visual & Media Requirements

Images

• Hero image specifications
• In-content images (how many, what type)
• Screenshots or diagrams
• Charts or infographics
• Alt text requirements

Video/Audio

• Video length and format
• Screen recordings needed
• B-roll requirements
• Audio quality standards

Other Media

• Code snippets
• Downloadable resources
• Interactive elements
• Embedded content

Workflow & Process

1. Brief Creation (This Skill)

Use `generate_brief.sh` to create comprehensive brief

2. Research & Outline

Writer researches and creates outline

3. First Draft

Writer creates content following brief

4. Review & Edit

Editor reviews against brief requirements

5. SEO Optimization

SEO review and optimization

6. Final Approval

Stakehold