generate-brand-context

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

# 🎯 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

## Question 1/4: Website URL

What is your official website URL?

Example: `https://example.com`

Question 2: Product Description

## 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

## 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

## 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:

## 📋 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:

# 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:

mkdir -p ./output/context

Step 5: Completion Message

## ✅ 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 - Uses brand context for relevant keyword discovery
• seo-content-writer - Uses tone for consistent content creation
• competitor-analysis - Uses keywords to find relevant competitors