---
name: seo-master
description: |
  Master SEO skill combining audit, planning, technical SEO, schema markup,
  content writing, fundamentals, and competitive analysis.
  Use when: SEO audit, SEO strategy, content optimization, technical SEO, schema markup.
---

# SEO Master

Comprehensive SEO skill combining: audit, planning, technical SEO, schema markup, content writing, fundamentals, and geo targeting.

---

## Quick Reference

| Task | Use Section |
|------|-------------|
| Diagnose SEO issues | **SEO Audit** |
| Build SEO strategy | **Strategic Planning** |
| Fix technical issues | **Technical SEO** |
| Add structured data | **Schema Markup** |
| Write SEO content | **Content Writing** |
| Learn SEO basics | **Fundamentals** |

---

## SEO Audit

**When to Use:** Diagnosing SEO issues affecting crawlability, indexation, rankings.

### Scope Gate (Ask First)
1. **Business Context** - Site type, goals, target markets
2. **SEO Focus** - Full site or specific sections?
3. **Data Access** - GSC, Analytics, known issues?

### Audit Framework (Priority Order)
1. **Crawlability & Indexation** - Can search engines access and index the site?
2. **Technical Foundations** - Speed, stability, accessibility
3. **On-Page Optimization** - Each page optimized for intent?
4. **Content Quality & E-E-A-T** - Does content deserve to rank?
5. **Authority & Signals** - Trust and relevance demonstration

---

## Strategic Planning

**When to Use:** Building SEO strategy for new or existing sites.

### Process
1. **Discovery** - Business type, audience, competitors, goals, KPIs
2. **Competitive Analysis** - Top 5 competitors, content strategy, keyword gaps
3. **Architecture Design** - URL hierarchy, content pillars, internal linking
4. **Content Strategy** - Topic clusters, content calendar
5. **Implementation Roadmap** - Phased approach with milestones

---

## Technical SEO

**When to Use:** Technical SEO review for crawlability, performance, rendering.

### Categories
1. **Crawlability** - robots.txt, XML sitemap, noindex tags
2. **Indexability** - Canonicals, hreflang, pagination
3. **Performance** - Core Web Vitals (LCP < 2.5s, INP < 200ms, CLS < 0.1)
4. **Mobile** - Responsive design, mobile-first indexing
5. **Security** - HTTPS, mixed content
6. **URLs** - Clean URLs, proper redirects
7. **JavaScript** - Rendering issues, hydration

---

## Schema Markup

**When to Use:** Detecting, validating, or generating Schema.org structured data.

### Common Schema Types
- `Organization` - Business info
- `WebSite` - Site-level markup
- `Article` - Blog posts, news
- `Product` - E-commerce
- `FAQPage` - FAQ content
- `HowTo` - Step-by-step instructions
- `LocalBusiness` - Local SEO
- `BreadcrumbList` - Navigation
- `VideoObject` - Video content
- `ImageObject` - Images

### Validation
- Google Rich Results Test: https://search.google.com/test/rich-results
- Schema.org Validator: https://validator.schema.org/

---

## Content Writing

**When to Use:** Writing SEO-optimized content.

### Best Practices
1. **Keyword Research** - Primary + secondary keywords, search intent
2. **Content Structure** - Clear headings (H1-H6), short paragraphs
3. **E-E-A-T Signals** - Author expertise, citations, experience
4. **Readability** - Flesch reading score, bullet points, images
5. **Internal Linking** - Relevant internal links
6. **Meta Tags** - Title tag (50-60 chars), meta description (150-160 chars)

---

## Fundamentals

### E-E-A-T Framework
| Dimension | What It Represents | Common Signals |
|-----------|-------------------|----------------|
| **Experience** | First-hand involvement | Original examples, demonstrations |
| **Expertise** | Subject-matter competence | Credentials, depth, accuracy |
| **Authoritativeness** | Recognition by others | Mentions, citations, links |
| **Trustworthiness** | Reliability and safety | HTTPS, transparency, accuracy |

### Core Web Vitals
| Metric | Target | What It Reflects |
|--------|--------|------------------|
| **LCP** | < 2.5s | Loading performance |
| **INP** | < 200ms | Interactivity |
| **CLS** | < 0.1 | Visual stability |

---

## Geo Targeting

**When to Use:** Multi-language or multi-regional SEO.

### Key Elements
- `hreflang` tags for language/region targeting
- `geo.region` meta tag
- LocalBusiness schema for local SEO
- Country-specific domain vs. subdomain vs. subdirectory
- Google Business Profile optimization

---

## DataForSEO Integration

**When to Use:** Automated keyword research, competitor analysis, rank tracking.

### Common API Endpoints
- Keywords Data API - Search volume, difficulty, CPC
- Keywords Research API - Related keywords, questions
- Domain Analytics API - Traffic estimation, top pages
- Backlinks API - Link analysis

---

## Implementation Checklist

- [ ] robots.txt allows important resources
- [ ] XML sitemap submitted to GSC
- [ ] HTTPS enabled with valid certificate
- [ ] Core Web Vitals passing
- [ ] Mobile-friendly design
- [ ] Clean URL structure
- [ ] Schema markup validated
- [ ] Content optimized for target keywords
- [ ] Internal linking strategy implemented
- [ ] GSC and Analytics configured
