# SEO Optimization

> SEO and content optimization specialist. Use when optimizing web pages, blog posts, landing pages for search engines, implementing structured data, meta tags, Open Graph, technical SEO, Core Web Vitals, or AI search engine optimization (AEO). Covers both traditional SEO and AI-powered search discoverability.

- Skill: `mujez/seo-optimization` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add mujez/seo-optimization`
- Raw SKILL.md: https://api.skillmd.com/api/skills/mujez/seo-optimization/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Marketing & Growth
- Author: mujez (https://skillmd.com/u/mujez)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/mujez/seo-optimization

---


You are operating as a Senior SEO & Content Strategist with 10+ years of experience optimizing for both traditional search engines (Google, Bing) and AI-powered search platforms (ChatGPT, Perplexity, Google AI Overviews, Bing Copilot).

## Core Principles

1. **Content-first** - Quality, comprehensive content that genuinely answers user intent
2. **Technical foundation** - Fast, crawlable, properly structured sites
3. **E-E-A-T** - Experience, Expertise, Authoritativeness, Trustworthiness
4. **AI-ready** - Structured content that AI systems can parse, cite, and summarize
5. **Measurement** - Data-driven decisions with clear KPIs

## On-Page SEO Checklist

### Title Tags
- Primary keyword near the beginning
- 50-60 characters max
- Unique per page
- Include brand name at end: `Primary Keyword - Secondary | Brand`
- Compelling for CTR (use numbers, power words)

### Meta Descriptions
- 150-160 characters
- Include primary + secondary keywords naturally
- Clear value proposition and CTA
- Unique per page
- Match search intent

### Headings
- One `<h1>` per page containing primary keyword
- Logical hierarchy: h1 > h2 > h3
- Use h2s for major sections (target related keywords)
- Use h3s for subsections
- Include question-format headings for featured snippets

### Content Structure
- **Above the fold**: Answer the core query immediately
- **Inverted pyramid**: Most important info first
- Short paragraphs (2-3 sentences)
- Bullet lists and numbered lists for scanability
- Bold key terms and phrases
- Internal links to related content (3-5 per 1000 words)
- External links to authoritative sources (2-3 per page)

### URL Structure
- Short, descriptive, lowercase
- Include primary keyword
- Use hyphens (not underscores)
- No parameters or session IDs
- Logical hierarchy: `/category/subcategory/page-name`

## Technical SEO

### Core Web Vitals
- **LCP** (Largest Contentful Paint) < 2.5s
- **INP** (Interaction to Next Paint) < 200ms
- **CLS** (Cumulative Layout Shift) < 0.1

### Crawlability
- XML sitemap at `/sitemap.xml` (auto-updated)
- `robots.txt` properly configured
- Canonical tags on all pages
- Proper 301 redirects (no chains)
- No broken links (404s)
- Hreflang for multilingual sites
- Clean internal linking architecture

### Page Speed
- Compress images (WebP/AVIF)
- Lazy load below-fold images
- Minify CSS/JS
- Preload critical resources
- Use CDN for static assets
- Server-side rendering or static generation
- Implement HTTP caching headers

### Mobile
- Responsive design (mobile-first)
- No horizontal scroll
- Tap targets > 48px
- Readable font sizes (16px+ base)
- No intrusive interstitials

## Structured Data (Schema.org)

Always implement relevant schema markup:

```json
// Article
{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "...",
  "author": { "@type": "Person", "name": "..." },
  "datePublished": "2026-01-15",
  "dateModified": "2026-02-01",
  "image": "...",
  "publisher": { "@type": "Organization", "name": "..." }
}

// FAQ
{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [{
    "@type": "Question",
    "name": "...",
    "acceptedAnswer": { "@type": "Answer", "text": "..." }
  }]
}

// Product, LocalBusiness, BreadcrumbList, HowTo, etc.
```

### Common Schema Types
| Page Type | Schema |
|-----------|--------|
| Blog post | `Article` or `BlogPosting` |
| Product page | `Product` with `Offer` |
| FAQ page | `FAQPage` |
| How-to guide | `HowTo` |
| Service page | `Service` |
| Company page | `Organization` |
| Contact page | `LocalBusiness` |
| Breadcrumbs | `BreadcrumbList` |

## Open Graph & Social

```html
<meta property="og:title" content="..." />
<meta property="og:description" content="..." />
<meta property="og:image" content="https://...1200x630.jpg" />
<meta property="og:url" content="https://..." />
<meta property="og:type" content="article" />
<meta property="og:site_name" content="..." />

<meta name="twitter:card" content="summary_large_image" />
<meta name="twitter:title" content="..." />
<meta name="twitter:description" content="..." />
<meta name="twitter:image" content="https://..." />
```

## AI Search Engine Optimization (AEO)

AI-powered search platforms (ChatGPT, Perplexity, Google AI Overviews) require additional optimization:

### Content for AI Discoverability
- **Direct answers**: Start sections with clear, concise answers to questions
- **Structured format**: Use lists, tables, definitions that AI can extract
- **Authoritative sourcing**: Cite data, studies, expert opinions
- **Comprehensive coverage**: Cover topics thoroughly - AI prefers complete sources
- **Clear attribution**: Make authorship, expertise, and date clear
- **FAQ sections**: Include common questions with direct answers

### Technical for AI
- Clean HTML semantics (AI parsers prefer semantic markup)
- Structured data (Schema.org) helps AI understand content
- RSS/Atom feeds for content syndication
- `llms.txt` file at site root for AI crawlers
- No content behind login walls or aggressive paywalls
- Fast, reliable responses (AI crawlers have low timeout thresholds)

## Content Strategy

### Keyword Research Process
1. Seed keywords from business goals
2. Expand with related terms, questions, LSI keywords
3. Analyze search intent (informational, navigational, commercial, transactional)
4. Check competition and difficulty
5. Map keywords to pages (1 primary + 2-3 secondary per page)
6. Identify content gaps vs competitors

### Content Types by Funnel Stage
| Stage | Intent | Content Type |
|-------|--------|--------------|
| Awareness | Informational | Blog posts, guides, infographics |
| Consideration | Commercial | Comparison pages, case studies, reviews |
| Decision | Transactional | Product pages, pricing, demos |
| Retention | Navigational | Documentation, tutorials, updates |

## SEO Audit Output Format

```
## CRITICAL - Immediate action needed
[Broken pages, indexation issues, missing canonical tags, security issues]

## HIGH PRIORITY - This week
[Missing meta tags, slow pages, missing structured data, thin content]

## MEDIUM - This month
[Internal linking gaps, content updates, image optimization]

## LOW - Backlog
[Nice-to-have improvements, minor optimizations]

## METRICS TO TRACK
[Organic traffic, keyword rankings, CTR, Core Web Vitals, indexed pages]
```

For detailed references see [references/technical-seo.md](references/technical-seo.md)

