Blog SEO Optimization

Create SEO content brief based on completed research using the SEO Specialist agent.

Usage

/blog-seo "topic-name"

Example:

/blog-seo "nodejs-tracing"

Note: Provide the sanitized topic name (same as used in research filename).

Prerequisites

Required: Research report must exist at .specify/research/[topic]-research.md

If research doesn't exist, run /blog-research first.

What This Command Does

Delegates to the seo-specialist subagent to create comprehensive SEO content brief:

• Extracts target keywords from research
• Analyzes search intent
• Creates content structure (H2/H3 outline)
• Generates 5-7 headline options
• Provides SEO recommendations
• Identifies internal linking opportunities

Time: 5-10 minutes Output: .specify/seo/[topic]-seo-brief.md

Instructions

Create a new subagent conversation with the seo-specialist agent.

Provide the following prompt:

You are creating an SEO content brief based on completed research.

**Research Report Path**: .specify/research/$ARGUMENTS-research.md

Read the research report and follow your Four-Phase Process:

1. **Keyword Analysis** (3-5 min):
   - Extract keyword candidates from research
   - Validate with web search (if available)
   - Select 1 primary + 3-5 secondary keywords
   - Identify 5-7 LSI keywords

2. **Search Intent Determination** (5-7 min):
   - Analyze top-ranking articles (if WebSearch available)
   - Classify intent (Informational/Navigational/Transactional)
   - Determine content format

3. **Content Structure Creation** (7-10 min):
   - Generate 5-7 headline options
   - Create H2/H3 outline covering all research topics
   - Write meta description (155 chars max)
   - Identify internal linking opportunities

4. **SEO Recommendations** (3-5 min):
   - Content length guidance
   - Keyword density targets
   - Image optimization suggestions
   - Schema markup recommendations
   - Featured snippet opportunities

**Output Location**: Save your SEO brief to `.specify/seo/$ARGUMENTS-seo-brief.md`

Begin your analysis now.

Expected Output

After completion, verify that .specify/seo/[topic]-seo-brief.md exists and contains:

Target keywords (primary, secondary, LSI) Search intent classification 5-7 headline options with recommendation Complete content structure (H2/H3 outline) Meta description (under 155 characters) SEO recommendations (length, density, images, schema) Internal linking opportunities Competitor insights summary

Review Checklist

Before proceeding to content creation, review:

1. Keywords: Are they appropriate for your goals?
2. Headlines: Do they resonate with your audience?
3. Structure: Does the H2/H3 outline make sense?
4. Intent: Does it match what you want to target?
5. Length: Is the target word count realistic?

Next Steps

After SEO brief is approved:

1. Proceed to writing: Run /blog-marketing to create final article
2. Or continue full workflow: If this was part of /blog-generate, the orchestrator will proceed automatically

When to Use This Command

Use /blog-seo when you need to:

• Regenerate SEO brief with different angle
• Update keywords for different target
• Adjust content structure
• Create brief only (without writing article)

For full workflow: Use /blog-generate instead.

Tips

1. Review headlines carefully: They drive CTR and engagement
2. Check structure depth: Too shallow? Too deep?
3. Validate intent: Wrong intent = wrong audience
4. Consider competition: Can you realistically rank?

Requesting Changes

If SEO brief needs adjustments, you can:

• Specify different primary keyword
• Request alternative headline approaches
• Adjust content structure (more/fewer sections)
• Change target word count

Just provide feedback and re-run the command with clarifications.

Error Handling

If SEO analysis fails:

• Verify research report exists
• Check file path is correct
• Ensure research contains sufficient content
• Try providing more specific guidance

---

Ready to start? Provide the topic name (from research filename) and execute this command.