seo-superpower

Dead-easy setup wizard. Walks you through Google Cloud + API keys + env wiring conversationally. ~5 minutes, no prior cloud experience needed.

One-call SEO. Diagnoses the site, routes to the right skill, ships a PR or a ranked list. Use without arguments to triage from scratch, or pass a phrase like "audit", "underserved keywords", "refresh stale content", or "bootstrap".

Use when adding JSON-LD structured data to a page — Article, BlogPosting, Product, FAQPage, HowTo, BreadcrumbList, Organization, WebSite, TouristTrip. Picks the right schema type for the page, populates required + key recommended fields from the actual content, validates against schema.org, and ships in a single PR. Triggers on "add schema", "add JSON-LD", "structured data", "rich results", "FAQ schema", "Article schema", "Product schema", "BreadcrumbList", "schema markup for [page]", or any time per-page schema is being added or audited.

Use when running a competitor SERP diff, asking why a competitor outranks you, building a content brief, or auditing what top-3 ranking pages cover that yours doesn't. Auto-triggers on "content gap analysis", "competitor SERP", "why does X outrank us", "what are competitors covering that we aren't", "content brief", "SERP analysis". Takes a target query + your URL, scrapes top-3 via Firecrawl, diffs entities/H2s/schema/depth/freshness/AIO presence, and ships `CONTENT_BRIEF.md` with gaps ranked by impact. Pairs with `optimizing-on-page` (fills the gaps) and `planning-topic-clusters` (when gaps span sub-topics).

Use when running a technical SEO audit, debugging Core Web Vitals regressions, checking indexability, validating schema and sitemaps, diagnosing why a site isn't ranking, or preparing a site for AI-search visibility (GPTBot, ClaudeBot, PerplexityBot). Covers crawlability, indexability, rendering, Core Web Vitals, schema, AI-search readiness, mobile, security, and meta basics. Lifecycle-aware — pre-launch, growth, mature. Produces a prioritized SEO_AUDIT.md and a low-risk fix PR.

Use when building Google E-E-A-T (Experience, Expertise, Authoritativeness, Trustworthiness) signals, writing author bios, planning thought-leadership SEO, hardening trust on YMYL (Your Money Your Life) content, getting cited as an authority by AI engines, or building a long-term authority moat from zero. Triggers on phrases like "E-E-A-T", "author bios", "build authority", "thought leadership SEO", "Google trust signals", "YMYL", "how to get cited as an authority". Long-game skill — invest 6+ months before you need it.

Use when optimizing existing pages for SEO, hunting low-hanging keyword opportunities, analyzing pages that get impressions in Google Search Console but few clicks, or planning a content refresh. Covers the full content lifecycle (initial → growth → mature) and integrates with Generative Engine Optimization (GEO) for AI-search visibility. Applies to any site with GSC access.