---
name: generate-brand-context
description: Interactive wizard to create site/brand context file (siteinfo.md) through guided Q&A. This context helps the SEO agent understand your brand, product, and content tone for more accurate keyword research and content generation.
---

# Generate Brand Context

This skill guides you through creating a brand context file (`./output/context/siteinfo.md`) that helps the SEO agent understand your website, product, and content style for more personalized and accurate SEO work.

## When to Use This Skill

- Setting up a new project for SEO optimization
- When `./output/context/siteinfo.md` doesn't exist
- When you want to update your brand context information
- Before starting keyword research or content creation

## What This Skill Does

Creates a structured `siteinfo.md` file containing:
- **website**: Your official website URL
- **description**: One-sentence product/service description
- **keywords**: Core keywords (comma-separated)
- **tone**: Content tone/style guidelines

## How to Use

```
Generate brand context for my website
```

```
Create siteinfo.md for my project
```

```
Set up brand context
```

## Instructions

When a user requests to generate brand context, follow this interactive Q&A flow:

### Step 1: Welcome & Explain

```markdown
# 🎯 Brand Context Setup

I'll help you create a brand context file that will make all SEO work more accurate and aligned with your brand.

This will only take a few minutes. I'll ask you 4 quick questions about your website/product.

Let's get started!
```

### Step 2: Ask Questions One by One

Ask each question separately, waiting for the user's response before proceeding:

**Question 1: Website URL**
```markdown
## Question 1/4: Website URL

What is your official website URL?

Example: `https://example.com`
```

**Question 2: Product Description**
```markdown
## Question 2/4: Product Description

Please provide a one-sentence description of your product or service.

Example: "An AI-powered project management tool that helps remote teams collaborate efficiently."
```

**Question 3: Core Keywords**
```markdown
## Question 3/4: Core Keywords

What are your core keywords? (comma-separated, 3-5 recommended)

These should be the main terms that describe your business, product, or service.

Example: `project management, team collaboration, remote work, productivity tool`
```

**Question 4: Content Tone**
```markdown
## Question 4/4: Content Tone

How would you describe your brand's content tone/style?

Examples:
- Professional and authoritative
- Friendly and conversational
- Technical and detailed
- Casual and approachable
- Innovative and forward-thinking
```

### Step 3: Confirm & Generate

After collecting all answers, show a preview:

```markdown
## 📋 Review Your Brand Context

Here's what I've captured:

| Field | Value |
|-------|-------|
| Website | [user's answer] |
| Description | [user's answer] |
| Keywords | [user's answer] |
| Tone | [user's answer] |

Does this look correct? (yes/no)
```

### Step 4: Create the File

If confirmed, create the file at `./output/context/siteinfo.md`:

```markdown
# Site Information

> Brand context for SEO optimization. This file is automatically loaded by the SEO agent.

## Website
[user's website URL]

## Description
[user's one-sentence description]

## Keywords
[user's comma-separated keywords]

## Tone
[user's content tone/style]

---
*Generated by generate-brand-context skill*
*Last updated: [current date]*
```

**Important**: Ensure the `./output/context/` directory exists before creating the file:

```bash
mkdir -p ./output/context
```

### Step 5: Completion Message

```markdown
## ✅ Brand Context Created!

Your brand context has been saved to `./output/context/siteinfo.md`.

This information will now be used to:
- 🔍 Generate more relevant keyword suggestions
- ✍️ Create content that matches your brand voice
- 🎯 Provide SEO recommendations aligned with your business

You can update this file anytime by running this skill again or editing the file directly.

**Ready to start?** Try:
- `Research keywords for my product`
- `Write SEO content about [topic]`
- `Analyze competitors for my keywords`
```

## Example Session

**User**: "Set up brand context"

**Agent**: 
```
# 🎯 Brand Context Setup

I'll help you create a brand context file that will make all SEO work more accurate and aligned with your brand.

Let's get started!

## Question 1/4: Website URL

What is your official website URL?
```

**User**: "https://acme-tools.com"

**Agent**:
```
## Question 2/4: Product Description

Please provide a one-sentence description of your product or service.
```

**User**: "Developer tools that automate code review and testing"

**Agent**:
```
## Question 3/4: Core Keywords

What are your core keywords? (comma-separated, 3-5 recommended)
```

**User**: "code review, automated testing, developer tools, CI/CD, code quality"

**Agent**:
```
## Question 4/4: Content Tone

How would you describe your brand's content tone/style?
```

**User**: "Technical but approachable, developer-friendly"

**Agent**:
```
## 📋 Review Your Brand Context

| Field | Value |
|-------|-------|
| Website | https://acme-tools.com |
| Description | Developer tools that automate code review and testing |
| Keywords | code review, automated testing, developer tools, CI/CD, code quality |
| Tone | Technical but approachable, developer-friendly |

Does this look correct?
```

**User**: "yes"

**Agent**: Creates `./output/context/siteinfo.md` and shows completion message.

## Tips

1. **Be specific with description**: A clear one-liner helps generate more focused content
2. **Choose keywords wisely**: These become the foundation for all keyword research
3. **Define tone clearly**: This ensures consistent voice across all generated content
4. **Update regularly**: As your brand evolves, update this file to keep SEO aligned

## Related Skills

- [keyword-research](../keyword-research/) - Uses brand context for relevant keyword discovery
- [seo-content-writer](../seo-content-writer/) - Uses tone for consistent content creation
- [competitor-analysis](../competitor-analysis/) - Uses keywords to find relevant competitors
