4.1 KiB
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:
- Keywords: Are they appropriate for your goals?
- Headlines: Do they resonate with your audience?
- Structure: Does the H2/H3 outline make sense?
- Intent: Does it match what you want to target?
- Length: Is the target word count realistic?
Next Steps
After SEO brief is approved:
- Proceed to writing: Run
/blog-marketingto create final article - 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
- Review headlines carefully: They drive CTR and engagement
- Check structure depth: Too shallow? Too deep?
- Validate intent: Wrong intent = wrong audience
- 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.