149 lines
4.1 KiB
Markdown
149 lines
4.1 KiB
Markdown
# Blog SEO Optimization
|
|
|
|
Create SEO content brief based on completed research using the SEO Specialist agent.
|
|
|
|
## Usage
|
|
|
|
```bash
|
|
/blog-seo "topic-name"
|
|
```
|
|
|
|
**Example**:
|
|
```bash
|
|
/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.
|