refactor: Refine SEO Expert agent with BMad Method integration
Based on critique and analysis:
Improvements:
- Aligned persona with BMad development workflow integration
- Simplified commands to use existing BMad tasks
- Created essential supporting files for immediate functionality
- Focused on development-time SEO rather than post-launch
Added supporting files:
- seo-audit.md: Comprehensive audit task workflow
- seo-audit-tmpl.yaml: Structured audit report template
- seo-requirements-tmpl.yaml: SEO requirements for PRD/Architecture
- seo-implementation-checklist.md: Actionable SEO checklist
Key refinements:
- Better integration with existing agents (Dev, Architect, UX)
- Story-driven SEO approach fitting sprint cycles
- Development-first mindset for built-in optimization
- Reuses existing BMad tasks (create-doc, execute-checklist, review-story)
This ensures SEO is embedded in the development process, not an afterthought.
🤖 Generated with Claude Code
Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
LegendT
parent
4246408e13
commit
ea01eb4e0f
|
|
@ -32,61 +32,44 @@ agent:
|
||||||
id: seo-expert
|
id: seo-expert
|
||||||
title: SEO & Digital Marketing Strategist
|
title: SEO & Digital Marketing Strategist
|
||||||
icon: 🔍
|
icon: 🔍
|
||||||
whenToUse: Use for SEO audits, keyword research, content optimization, technical SEO implementation, search rankings analysis, and digital marketing strategy
|
whenToUse: Use for SEO audits, technical SEO requirements, content optimization guidance, and search visibility planning during project development
|
||||||
customization: null
|
customization: null
|
||||||
persona:
|
persona:
|
||||||
role: Strategic SEO Expert & Digital Marketing Optimizer
|
role: Technical SEO Specialist & Search Optimization Architect
|
||||||
style: Data-driven, strategic, technical yet accessible, results-focused, proactive
|
style: Analytical, precise, collaborative, implementation-focused, standards-driven
|
||||||
identity: SEO specialist who bridges technical implementation with content strategy and business goals
|
identity: SEO expert who integrates search optimization into the BMad development workflow, ensuring SEO is built-in, not bolted-on
|
||||||
focus: Search visibility, organic growth, technical optimization, content strategy, measurable outcomes
|
focus: Technical SEO requirements, development-friendly optimization, measurable search performance, agile SEO integration
|
||||||
core_principles:
|
core_principles:
|
||||||
- Data-Driven Decision Making - Base all recommendations on analytics and proven SEO metrics
|
- Development Integration First - Embed SEO requirements directly into user stories and architecture docs
|
||||||
- Holistic SEO Approach - Balance technical, content, and authority-building strategies
|
- Technical Foundation - Ensure proper technical SEO implementation from the start
|
||||||
- User Intent Alignment - Prioritize user experience and search intent over keyword stuffing
|
- Collaborative Workflow - Work seamlessly with Dev, Architect, and UX agents
|
||||||
- Technical Excellence - Ensure crawlability, indexability, and optimal site performance
|
- Story-Driven SEO - Create actionable SEO tasks that fit the sprint cycle
|
||||||
- Content Quality First - Create valuable content that serves users while optimizing for search
|
- Performance Metrics - Define clear, measurable SEO acceptance criteria
|
||||||
- Competitive Intelligence - Monitor and learn from competitor strategies and market trends
|
- BMad Method Alignment - Follow established documentation and workflow patterns
|
||||||
- Measurable Impact - Focus on KPIs that directly affect business outcomes
|
- Proactive Optimization - Identify SEO needs during planning, not after deployment
|
||||||
- White-Hat Practices - Follow search engine guidelines and ethical SEO practices
|
- Standards Compliance - Ensure adherence to web standards and accessibility
|
||||||
- Continuous Optimization - Iterate based on performance data and algorithm updates
|
- User-Centric Approach - Balance search optimization with user experience
|
||||||
- Cross-Team Collaboration - Bridge gap between content, development, and marketing teams
|
- Continuous Monitoring - Establish tracking and reporting from project inception
|
||||||
- Numbered Options Protocol - Always use numbered lists for selections
|
- Numbered Options Protocol - Always use numbered lists for selections
|
||||||
# All commands require * prefix when used (e.g., *help)
|
# All commands require * prefix when used (e.g., *help)
|
||||||
commands:
|
commands:
|
||||||
- help: Show numbered list of the following commands to allow selection
|
- help: Show numbered list of the following commands to allow selection
|
||||||
- site-audit: Perform comprehensive SEO audit (task execute-seo-audit with seo-audit-tmpl.yaml)
|
- audit-site: Perform comprehensive SEO audit (task seo-audit with seo-audit-tmpl.yaml)
|
||||||
- keyword-research: Conduct keyword research and opportunity analysis (task keyword-research with keyword-research-tmpl.yaml)
|
- create-seo-requirements: Generate SEO requirements for PRD/Architecture (task create-doc with seo-requirements-tmpl.yaml)
|
||||||
- content-optimize: Optimize content for target keywords (task optimize-content with content-optimization-checklist.md)
|
- review-story-seo: Review story for SEO considerations (task review-story)
|
||||||
- technical-seo: Execute technical SEO improvements (task technical-seo-implementation)
|
- seo-checklist: Execute SEO implementation checklist (task execute-checklist with seo-implementation-checklist.md)
|
||||||
- competitor-analysis: Analyze competitor SEO strategies (task seo-competitor-analysis with seo-competitor-tmpl.yaml)
|
|
||||||
- create-content-strategy: Develop content strategy based on SEO insights (task create-doc with content-strategy-tmpl.yaml)
|
|
||||||
- monitor-rankings: Set up and review ranking tracking (task monitor-search-performance)
|
|
||||||
- local-seo: Optimize for local search (task local-seo-optimization)
|
|
||||||
- link-analysis: Analyze and improve link profile (task backlink-analysis)
|
|
||||||
- yolo: Toggle Yolo Mode
|
- yolo: Toggle Yolo Mode
|
||||||
- doc-out: Output full document in progress to current destination file
|
- doc-out: Output full document in progress to current destination file
|
||||||
- exit: Say goodbye as the SEO Expert, and then abandon inhabiting this persona
|
- exit: Say goodbye as the SEO Expert, and then abandon inhabiting this persona
|
||||||
dependencies:
|
dependencies:
|
||||||
tasks:
|
tasks:
|
||||||
- execute-seo-audit.md
|
- seo-audit.md
|
||||||
- keyword-research.md
|
|
||||||
- optimize-content.md
|
|
||||||
- technical-seo-implementation.md
|
|
||||||
- seo-competitor-analysis.md
|
|
||||||
- monitor-search-performance.md
|
|
||||||
- local-seo-optimization.md
|
|
||||||
- backlink-analysis.md
|
|
||||||
- create-doc.md
|
- create-doc.md
|
||||||
|
- review-story.md
|
||||||
|
- execute-checklist.md
|
||||||
templates:
|
templates:
|
||||||
- seo-audit-tmpl.yaml
|
- seo-audit-tmpl.yaml
|
||||||
- keyword-research-tmpl.yaml
|
- seo-requirements-tmpl.yaml
|
||||||
- seo-competitor-tmpl.yaml
|
|
||||||
- content-strategy-tmpl.yaml
|
|
||||||
checklists:
|
checklists:
|
||||||
- content-optimization-checklist.md
|
- seo-implementation-checklist.md
|
||||||
- technical-seo-checklist.md
|
|
||||||
- local-seo-checklist.md
|
|
||||||
data:
|
|
||||||
- seo-best-practices.md
|
|
||||||
- search-algorithm-factors.md
|
|
||||||
```
|
```
|
||||||
|
|
@ -0,0 +1,85 @@
|
||||||
|
# SEO Implementation Checklist
|
||||||
|
|
||||||
|
## Technical SEO
|
||||||
|
- [ ] Verify robots.txt is properly configured
|
||||||
|
- [ ] Generate and submit XML sitemap
|
||||||
|
- [ ] Implement canonical URLs
|
||||||
|
- [ ] Set up 301 redirects for moved content
|
||||||
|
- [ ] Enable HTTPS across entire site
|
||||||
|
- [ ] Configure hreflang tags (if multi-language)
|
||||||
|
- [ ] Implement structured data markup (Schema.org)
|
||||||
|
- [ ] Optimize site speed and Core Web Vitals
|
||||||
|
- [ ] Fix crawl errors in Search Console
|
||||||
|
- [ ] Ensure mobile responsiveness
|
||||||
|
|
||||||
|
## On-Page Optimization
|
||||||
|
- [ ] Optimize title tags (unique, 50-60 chars)
|
||||||
|
- [ ] Write compelling meta descriptions (150-160 chars)
|
||||||
|
- [ ] Structure content with proper H1-H6 hierarchy
|
||||||
|
- [ ] Optimize images (compression, alt text, filenames)
|
||||||
|
- [ ] Implement internal linking strategy
|
||||||
|
- [ ] Create SEO-friendly URL structure
|
||||||
|
- [ ] Add breadcrumb navigation
|
||||||
|
- [ ] Optimize for featured snippets
|
||||||
|
- [ ] Update outdated content
|
||||||
|
- [ ] Fix broken links
|
||||||
|
|
||||||
|
## Content Strategy
|
||||||
|
- [ ] Conduct keyword research
|
||||||
|
- [ ] Map keywords to user intent
|
||||||
|
- [ ] Create content calendar
|
||||||
|
- [ ] Develop topic clusters
|
||||||
|
- [ ] Write comprehensive, valuable content
|
||||||
|
- [ ] Optimize for semantic search
|
||||||
|
- [ ] Include relevant LSI keywords
|
||||||
|
- [ ] Add FAQ sections where appropriate
|
||||||
|
- [ ] Create location-specific content (if local)
|
||||||
|
- [ ] Implement content refresh schedule
|
||||||
|
|
||||||
|
## Off-Page SEO
|
||||||
|
- [ ] Audit existing backlink profile
|
||||||
|
- [ ] Disavow toxic backlinks
|
||||||
|
- [ ] Develop link building strategy
|
||||||
|
- [ ] Create linkable assets
|
||||||
|
- [ ] Build local citations (if applicable)
|
||||||
|
- [ ] Monitor brand mentions
|
||||||
|
- [ ] Engage in relevant communities
|
||||||
|
- [ ] Guest posting outreach
|
||||||
|
- [ ] Partner/supplier link opportunities
|
||||||
|
- [ ] Social media optimization
|
||||||
|
|
||||||
|
## Analytics & Monitoring
|
||||||
|
- [ ] Set up Google Analytics 4
|
||||||
|
- [ ] Configure Google Search Console
|
||||||
|
- [ ] Implement conversion tracking
|
||||||
|
- [ ] Set up rank tracking
|
||||||
|
- [ ] Create custom dashboards
|
||||||
|
- [ ] Configure automated reporting
|
||||||
|
- [ ] Set up alerts for issues
|
||||||
|
- [ ] Monitor Core Web Vitals
|
||||||
|
- [ ] Track keyword rankings
|
||||||
|
- [ ] Monitor competitor performance
|
||||||
|
|
||||||
|
## Local SEO (if applicable)
|
||||||
|
- [ ] Claim Google Business Profile
|
||||||
|
- [ ] Optimize GBP listing
|
||||||
|
- [ ] Build local citations
|
||||||
|
- [ ] Gather customer reviews
|
||||||
|
- [ ] Create location pages
|
||||||
|
- [ ] Implement local schema markup
|
||||||
|
- [ ] Optimize for "near me" searches
|
||||||
|
- [ ] Join local business directories
|
||||||
|
- [ ] Create locally-relevant content
|
||||||
|
- [ ] Build local backlinks
|
||||||
|
|
||||||
|
## E-commerce SEO (if applicable)
|
||||||
|
- [ ] Optimize product pages
|
||||||
|
- [ ] Create unique product descriptions
|
||||||
|
- [ ] Implement product schema
|
||||||
|
- [ ] Optimize category pages
|
||||||
|
- [ ] Add customer reviews
|
||||||
|
- [ ] Create buying guides
|
||||||
|
- [ ] Optimize for commercial intent
|
||||||
|
- [ ] Implement faceted navigation properly
|
||||||
|
- [ ] Handle out-of-stock products
|
||||||
|
- [ ] Optimize checkout process
|
||||||
|
|
@ -0,0 +1,53 @@
|
||||||
|
# SEO Audit Task
|
||||||
|
|
||||||
|
## Purpose
|
||||||
|
Conduct comprehensive SEO audit to identify optimization opportunities and technical issues affecting search visibility.
|
||||||
|
|
||||||
|
## Task Instructions
|
||||||
|
|
||||||
|
### 1. Technical SEO Assessment
|
||||||
|
Analyze technical foundation:
|
||||||
|
- Site crawlability and indexability
|
||||||
|
- XML sitemap presence and validity
|
||||||
|
- Robots.txt configuration
|
||||||
|
- Site speed and Core Web Vitals
|
||||||
|
- Mobile responsiveness
|
||||||
|
- HTTPS implementation
|
||||||
|
- Canonical URL setup
|
||||||
|
- Structured data markup
|
||||||
|
|
||||||
|
### 2. On-Page SEO Analysis
|
||||||
|
Review content optimization:
|
||||||
|
- Title tags and meta descriptions
|
||||||
|
- Header tag hierarchy (H1-H6)
|
||||||
|
- Internal linking structure
|
||||||
|
- Image optimization and alt text
|
||||||
|
- Content quality and keyword usage
|
||||||
|
- URL structure and permalinks
|
||||||
|
- Duplicate content issues
|
||||||
|
|
||||||
|
### 3. Off-Page SEO Review
|
||||||
|
Evaluate external factors:
|
||||||
|
- Backlink profile quality
|
||||||
|
- Domain authority metrics
|
||||||
|
- Brand mentions and citations
|
||||||
|
- Social signals
|
||||||
|
- Competitor comparison
|
||||||
|
|
||||||
|
### 4. Content Gap Analysis
|
||||||
|
Identify opportunities:
|
||||||
|
- Missing topic coverage
|
||||||
|
- Keyword opportunities
|
||||||
|
- Content depth requirements
|
||||||
|
- User intent alignment
|
||||||
|
|
||||||
|
### 5. Generate Audit Report
|
||||||
|
Create comprehensive report using seo-audit-tmpl.yaml including:
|
||||||
|
- Executive summary
|
||||||
|
- Priority issues matrix
|
||||||
|
- Detailed findings by category
|
||||||
|
- Actionable recommendations
|
||||||
|
- Implementation roadmap
|
||||||
|
|
||||||
|
## Output
|
||||||
|
Structured SEO audit document with prioritized action items and implementation timeline.
|
||||||
|
|
@ -0,0 +1,127 @@
|
||||||
|
template:
|
||||||
|
name: SEO Audit Report
|
||||||
|
version: 1.0
|
||||||
|
description: Comprehensive SEO audit documentation template
|
||||||
|
sections:
|
||||||
|
- name: Executive Summary
|
||||||
|
required: true
|
||||||
|
prompts:
|
||||||
|
- Current SEO performance overview
|
||||||
|
- Critical issues impacting visibility
|
||||||
|
- Top 3-5 priority recommendations
|
||||||
|
- Expected impact of improvements
|
||||||
|
|
||||||
|
- name: Technical SEO Analysis
|
||||||
|
required: true
|
||||||
|
subsections:
|
||||||
|
- name: Site Architecture
|
||||||
|
prompts:
|
||||||
|
- Crawlability assessment
|
||||||
|
- Indexation status
|
||||||
|
- XML sitemap analysis
|
||||||
|
- Robots.txt review
|
||||||
|
- name: Performance Metrics
|
||||||
|
prompts:
|
||||||
|
- Page speed scores (Mobile/Desktop)
|
||||||
|
- Core Web Vitals (LCP, FID, CLS)
|
||||||
|
- Server response times
|
||||||
|
- Resource optimization needs
|
||||||
|
- name: Mobile Optimization
|
||||||
|
prompts:
|
||||||
|
- Mobile responsiveness issues
|
||||||
|
- Mobile-specific user experience
|
||||||
|
- AMP implementation (if applicable)
|
||||||
|
|
||||||
|
- name: On-Page SEO Assessment
|
||||||
|
required: true
|
||||||
|
subsections:
|
||||||
|
- name: Content Optimization
|
||||||
|
prompts:
|
||||||
|
- Title tag analysis
|
||||||
|
- Meta description review
|
||||||
|
- Header structure (H1-H6)
|
||||||
|
- Keyword density and placement
|
||||||
|
- name: Internal Linking
|
||||||
|
prompts:
|
||||||
|
- Link structure analysis
|
||||||
|
- Anchor text distribution
|
||||||
|
- Orphan pages identification
|
||||||
|
- Link depth assessment
|
||||||
|
|
||||||
|
- name: Off-Page SEO Factors
|
||||||
|
required: true
|
||||||
|
subsections:
|
||||||
|
- name: Backlink Profile
|
||||||
|
prompts:
|
||||||
|
- Total backlinks and referring domains
|
||||||
|
- Link quality assessment
|
||||||
|
- Toxic link identification
|
||||||
|
- Competitor backlink gap
|
||||||
|
- name: Brand Authority
|
||||||
|
prompts:
|
||||||
|
- Domain authority metrics
|
||||||
|
- Brand mention tracking
|
||||||
|
- Local citations (if applicable)
|
||||||
|
|
||||||
|
- name: Content Analysis
|
||||||
|
required: true
|
||||||
|
subsections:
|
||||||
|
- name: Content Quality
|
||||||
|
prompts:
|
||||||
|
- Thin content identification
|
||||||
|
- Duplicate content issues
|
||||||
|
- Content freshness assessment
|
||||||
|
- E-E-A-T factors
|
||||||
|
- name: Keyword Opportunities
|
||||||
|
prompts:
|
||||||
|
- Current keyword rankings
|
||||||
|
- Keyword gap analysis
|
||||||
|
- Search intent alignment
|
||||||
|
- Featured snippet opportunities
|
||||||
|
|
||||||
|
- name: Competitive Analysis
|
||||||
|
required: false
|
||||||
|
prompts:
|
||||||
|
- Top 3-5 competitors identified
|
||||||
|
- Competitive advantages/disadvantages
|
||||||
|
- Content gap opportunities
|
||||||
|
- Technical differentiators
|
||||||
|
|
||||||
|
- name: Priority Action Matrix
|
||||||
|
required: true
|
||||||
|
subsections:
|
||||||
|
- name: Critical Issues
|
||||||
|
prompts:
|
||||||
|
- Issues blocking crawling/indexing
|
||||||
|
- Major technical problems
|
||||||
|
- Immediate fixes needed
|
||||||
|
- name: High Priority
|
||||||
|
prompts:
|
||||||
|
- Quick wins with high impact
|
||||||
|
- Important optimizations
|
||||||
|
- 30-day action items
|
||||||
|
- name: Medium Priority
|
||||||
|
prompts:
|
||||||
|
- Ongoing improvements
|
||||||
|
- 60-90 day initiatives
|
||||||
|
- Content enhancements
|
||||||
|
- name: Low Priority
|
||||||
|
prompts:
|
||||||
|
- Nice-to-have improvements
|
||||||
|
- Long-term initiatives
|
||||||
|
|
||||||
|
- name: Implementation Roadmap
|
||||||
|
required: true
|
||||||
|
prompts:
|
||||||
|
- Week 1-2 tasks
|
||||||
|
- Month 1 deliverables
|
||||||
|
- Quarter 1 goals
|
||||||
|
- Success metrics and KPIs
|
||||||
|
|
||||||
|
- name: Monitoring Plan
|
||||||
|
required: true
|
||||||
|
prompts:
|
||||||
|
- Key metrics to track
|
||||||
|
- Reporting frequency
|
||||||
|
- Tools and dashboards
|
||||||
|
- Success benchmarks
|
||||||
|
|
@ -0,0 +1,83 @@
|
||||||
|
template:
|
||||||
|
name: SEO Requirements Document
|
||||||
|
version: 1.0
|
||||||
|
description: SEO requirements to be integrated into PRD and Architecture documents
|
||||||
|
sections:
|
||||||
|
- name: SEO Objectives
|
||||||
|
required: true
|
||||||
|
prompts:
|
||||||
|
- Primary SEO goals for this project
|
||||||
|
- Target audience search behavior
|
||||||
|
- Key performance indicators (KPIs)
|
||||||
|
- Success metrics and benchmarks
|
||||||
|
|
||||||
|
- name: Technical SEO Requirements
|
||||||
|
required: true
|
||||||
|
subsections:
|
||||||
|
- name: Site Architecture
|
||||||
|
prompts:
|
||||||
|
- URL structure requirements
|
||||||
|
- Navigation hierarchy for SEO
|
||||||
|
- Internal linking strategy
|
||||||
|
- Sitemap generation needs
|
||||||
|
- name: Performance Requirements
|
||||||
|
prompts:
|
||||||
|
- Page speed targets (Mobile/Desktop)
|
||||||
|
- Core Web Vitals requirements
|
||||||
|
- Image optimization standards
|
||||||
|
- Code optimization needs
|
||||||
|
- name: Crawlability & Indexing
|
||||||
|
prompts:
|
||||||
|
- Robots.txt configuration
|
||||||
|
- Canonical URL strategy
|
||||||
|
- Pagination handling
|
||||||
|
- JavaScript rendering requirements
|
||||||
|
|
||||||
|
- name: Content Requirements
|
||||||
|
required: true
|
||||||
|
subsections:
|
||||||
|
- name: Content Structure
|
||||||
|
prompts:
|
||||||
|
- Page template SEO requirements
|
||||||
|
- Meta data requirements
|
||||||
|
- Heading hierarchy standards
|
||||||
|
- Content depth guidelines
|
||||||
|
- name: Keyword Strategy
|
||||||
|
prompts:
|
||||||
|
- Primary keyword targets
|
||||||
|
- Secondary keywords
|
||||||
|
- Long-tail opportunities
|
||||||
|
- Semantic keyword clusters
|
||||||
|
|
||||||
|
- name: Development Considerations
|
||||||
|
required: true
|
||||||
|
prompts:
|
||||||
|
- Schema markup implementation
|
||||||
|
- Open Graph and Twitter Cards
|
||||||
|
- Accessibility requirements (overlap with SEO)
|
||||||
|
- Mobile-first development approach
|
||||||
|
- Progressive enhancement strategy
|
||||||
|
|
||||||
|
- name: User Story SEO Criteria
|
||||||
|
required: true
|
||||||
|
prompts:
|
||||||
|
- SEO acceptance criteria for stories
|
||||||
|
- Testing requirements for SEO features
|
||||||
|
- Performance benchmarks for stories
|
||||||
|
- SEO validation checkpoints
|
||||||
|
|
||||||
|
- name: Monitoring & Analytics
|
||||||
|
required: true
|
||||||
|
prompts:
|
||||||
|
- Analytics implementation requirements
|
||||||
|
- Search Console setup needs
|
||||||
|
- Tracking and reporting setup
|
||||||
|
- Dashboard and alerting requirements
|
||||||
|
|
||||||
|
- name: Integration Points
|
||||||
|
required: true
|
||||||
|
prompts:
|
||||||
|
- CMS/backend SEO features needed
|
||||||
|
- API requirements for SEO data
|
||||||
|
- Third-party tool integrations
|
||||||
|
- CDN and caching considerations
|
||||||
Loading…
Reference in New Issue