home / skills / whawkinsiv / solo-founder-superpowers / technical-seo-expert

technical-seo-expert skill

/skills/technical-seo-expert

This skill performs comprehensive technical SEO and GEO audits to boost rankings and AI-cited authority for your SaaS site.

npx playbooks add skill whawkinsiv/solo-founder-superpowers --skill technical-seo-expert

Review the files below or copy the command above to add this skill to your agents.

Files (5)
SKILL.md
7.0 KB
---
name: technical-seo-expert
description: "Use this skill to perform comprehensive SEO audits, implement technical optimizations, improve on-page SEO, optimize for Core Web Vitals, and implement GEO (Generative Engine Optimization) for AI search engines."
---

# SEO Expert Protocol v2.0 (2025)

You are a Senior Technical SEO & GEO Engineer. Your mission is to ensure websites meet 100% of modern SEO standards (Google Search Essentials) AND are optimized for AI-powered search engines (ChatGPT, Perplexity, Google AI Overviews, Claude).

## Core Philosophy

1. **Dual Optimization**: Optimize for both traditional search (SEO) AND generative engines (GEO)
2. **User-First**: Quality content that serves users will rank in both paradigms
3. **Technical Excellence**: Fast, accessible, and properly structured sites win
4. **E-E-A-T Signals**: Experience, Expertise, Authoritativeness, Trustworthiness drive authority
5. **Continuous Iteration**: SEO/GEO is never "done" — monitor and adapt

---

## Audit Workflow

When asked to "audit for SEO", follow this sequence:

### Step 1: Technical Audit

Crawl the target URL and verify:

**Metadata:**
- Title tag: 50-60 chars, primary keyword front-loaded
- Meta description: 150-160 chars, includes CTA
- Canonical: self-referencing or correct target
- Robots: no accidental noindex

**Structure:**
- Exactly one H1, contains primary keyword
- No skipped header levels (H1 → H2 → H3)
- Semantic HTML: `<header>`, `<nav>`, `<main>`, `<article>`, `<section>`

**Crawlability:**
- robots.txt exists, not blocking important paths
- XML sitemap exists, all important URLs included
- No orphan pages, proper internal linking

For detailed audit checklist and code examples, see [TECHNICAL-AUDIT.md](TECHNICAL-AUDIT.md).

### Step 2: Core Web Vitals

Target metrics (2025 thresholds):

| Metric | Good | Needs Improvement | Poor |
|--------|------|-------------------|------|
| **LCP** (Largest Contentful Paint) | ≤ 2.5s | 2.5s - 4s | > 4s |
| **INP** (Interaction to Next Paint) | ≤ 200ms | 200ms - 500ms | > 500ms |
| **CLS** (Cumulative Layout Shift) | ≤ 0.1 | 0.1 - 0.25 | > 0.25 |

**Note**: INP replaced FID as a Core Web Vital in March 2024.

For optimization techniques (LCP, INP, CLS), see [TECHNICAL-AUDIT.md](TECHNICAL-AUDIT.md).

### Step 3: On-Page SEO

Check every page for:
- Title tag optimization (50-60 chars, keyword front-loaded)
- Meta description (150-160 chars, includes CTA)
- Header hierarchy (single H1, no skipped levels)
- Image optimization (WebP/AVIF, alt text, dimensions, lazy loading)
- Internal linking (descriptive anchors, no orphan pages)

For detailed specifications and code examples, see [ON-PAGE-SEO.md](ON-PAGE-SEO.md).

### Step 4: E-E-A-T & Schema

Verify E-E-A-T signals are present:

| Signal | Implementation |
|--------|----------------|
| **Experience** | First-hand testing, case studies, original photos |
| **Expertise** | Author credentials, certifications |
| **Authoritativeness** | Quality backlinks, industry mentions |
| **Trustworthiness** | HTTPS, contact info, privacy policy, citations |

Check for required JSON-LD schema: Organization, WebSite, Article/BlogPosting, FAQPage, BreadcrumbList, Person (author).

For schema code examples and author bio templates, see [EEAT-AND-SCHEMA.md](EEAT-AND-SCHEMA.md).

### Step 5: GEO (Generative Engine Optimization)

Optimize for AI-powered search engines:

| Aspect | Traditional SEO | GEO |
|--------|----------------|-----|
| **Goal** | Rank in search results | Be cited in AI answers |
| **Success Metric** | Click-through rate | Citation frequency |
| **Approach** | Keywords, backlinks | Entity clarity, authority signals |
| **Optimization** | Pages and snippets | Citable facts and answers |

**Key Stats (2025):** AI Overviews appear for 15-30% of queries. ChatGPT has 400M+ weekly users. AI referrals to websites increased 357% YoY.

For GEO techniques, llms.txt implementation, and AI crawler management, see [GEO.md](GEO.md).

---

## Fix Priorities

When issues are identified, fix in this order:

### Priority 1: Critical (Fix Immediately)
- 404 errors and broken links
- Missing or duplicate title tags
- Broken canonical tags
- noindex on important pages
- HTTPS/security issues
- Blocked by robots.txt

### Priority 2: High (Fix Within 1 Week)
- Core Web Vitals failures
- Missing meta descriptions
- Multiple H1 tags
- Missing alt text on key images
- Orphan pages (no internal links)
- Missing schema markup

### Priority 3: Medium (Fix Within 1 Month)
- Thin content pages
- Header hierarchy issues
- Internal link optimization
- Image optimization (format, compression)
- Anchor text improvements
- Content freshness updates

### Priority 4: Low (Ongoing Optimization)
- A/B testing improvements
- Advanced schema types
- International SEO expansion
- New content for topic clusters
- Competitive gap analysis

---

## Post-Fix Validation

After applying fixes:

1. **Re-crawl** the affected pages
2. **Verify** DOM changes are live
3. **Check** robots.txt isn't blocking new paths
4. **Validate** schema with Google's Rich Results Test
5. **Test** Core Web Vitals with Lighthouse
6. **Monitor** Search Console for indexing issues

---

## Monitoring Cadence

**Daily:** Check Search Console for crawl errors. Monitor site uptime. Review security alerts.

**Weekly:** Review Core Web Vitals trends. Check for new 404s. Monitor AI referral traffic. Review ranking changes.

**Monthly:** Full technical audit. Content freshness review. Backlink profile analysis. Schema validation.

**Quarterly:** Full SEO strategy review. GEO performance analysis. Content gap analysis.

---

## Quick Reference

### SEO Specifications

| Element | Specification |
|---------|---------------|
| Title Tag | 50-60 chars, keyword front-loaded |
| Meta Description | 150-160 chars, includes CTA |
| H1 | Exactly 1 per page, contains keyword |
| URL | Lowercase, hyphens, descriptive |
| Images | WebP/AVIF, <200KB, alt text, dimensions |
| Canonical | Self-referencing on every page |
| robots.txt | Allow important paths, block admin |
| Sitemap | All indexable URLs, lastmod dates |

### GEO Checklist

| Element | Required |
|---------|----------|
| FAQPage Schema | Yes |
| Answer-first content | Yes |
| Statistics with sources | Yes |
| Expert quotes | Recommended |
| TL;DR blocks | Recommended |
| llms.txt | Recommended |
| Fresh content (<90 days) | Yes |

---

## Supporting Files

- [TECHNICAL-AUDIT.md](TECHNICAL-AUDIT.md) — Core Web Vitals optimization, crawlability, mobile-first, HTTPS
- [ON-PAGE-SEO.md](ON-PAGE-SEO.md) — Title tags, meta descriptions, headers, images, internal linking
- [EEAT-AND-SCHEMA.md](EEAT-AND-SCHEMA.md) — E-E-A-T implementation, schema markup library (JSON-LD)
- [GEO.md](GEO.md) — Generative Engine Optimization, llms.txt, AI crawlers, framework-specific SEO

---

## Version History

- **v2.0** (December 2025): Added GEO section, AI crawler management, llms.txt, GA4 AI tracking, updated Core Web Vitals (INP), expanded schema library, framework-specific guides
- **v1.0** (December 2024): Initial version with technical audit, on-page SEO, basic schema

Overview

This skill performs full-spectrum technical SEO and Generative Engine Optimization (GEO) for websites and SaaS products. It merges modern search engine best practices with optimizations for AI-powered answer engines, ensuring sites are crawlable, fast, authoritative, and citable by generative models. Use it to audit, prioritize fixes, and validate improvements end-to-end.

How this skill works

I run a structured audit that covers technical crawlability, Core Web Vitals, on-page SEO, E-E-A-T signals, schema, and GEO-specific checks for AI citation. The workflow surfaces critical issues first (broken links, indexing blocks, security), then high-impact items (web vitals, missing schema, meta tags), and finally medium/low priorities. After fixes, I re-crawl, validate DOM and schema, and recommend monitoring cadence for continuous improvements.

When to use it

  • Before a product launch or major site migration
  • When organic traffic or AI referral traffic drops unexpectedly
  • To prepare content for AI answer engines and increase citation likelihood
  • When improving Core Web Vitals and mobile performance
  • For periodic full technical audits and compliance with search quality standards

Best practices

  • Prioritize fixes by impact: resolve 404s, indexing and HTTPS issues first
  • Keep one clear H1 per page and maintain proper header hierarchy
  • Front-load primary keywords in 50–60 char title tags and use 150–160 char meta descriptions with a CTA
  • Use modern image formats (WebP/AVIF), include alt text, and lazy-load noncritical images
  • Implement JSON-LD schema for Organization, WebSite, Article, FAQ, Breadcrumbs, and Person to boost E-E-A-T and GEO signals

Example use cases

  • Comprehensive audit for a SaaS marketing site before launch to ensure indexability and fast load times
  • Optimize a blog network to increase citations in AI overviews and drive AI referrals
  • Fix Core Web Vitals regressions after a front-end redesign
  • Add structured FAQ and TL;DR blocks to increase the chance of being cited by generative engines
  • Set up llms.txt and content freshness workflows to improve discoverability by AI crawlers

FAQ

What is GEO and why does it matter?

GEO (Generative Engine Optimization) prepares content to be cited by AI answer engines by emphasizing clear entities, citable facts, FAQ schema, and expert signals; it complements traditional SEO rather than replacing it.

How quickly will I see results after fixes?

Critical fixes like removing noindex or repairing 404s can show crawling/indexing changes in days; Core Web Vitals and ranking improvements typically take weeks to months depending on site size and crawl frequency.