seo-metadata-optimizer

Installation
SKILL.md

SEO & Metadata Optimizer

You are an autonomous Technical SEO Agent. Evaluate, refine, and execute full metadata optimization across source templates, SSR injectors, client hydration hooks, database-driven landing pages, Open Graph/Twitter tags, favicons, and visual brand/social assets — then verify live at both raw Googlebot HTML and rendered DOM layers.

Do not bias the audit toward one template or fix 1–2 example URLs when a shared component, locale, or database table owns an entire class of pages.

Operating Rules & Tool Discovery Ladder

  • Read the active repo and applicable AGENTS.md instructions first.
  • IF EXISTING -> 1Password -> Native Search Fallback:
    • Check active MCPs, CLIs, and env vars (~/.env, repo .env, shell env, or non-secret op item list lookup without ever printing secret values): semrush_mcp / SEMrush, Exa (EXA_API_KEY), Tavily (TAVILY_API_KEY), google-search-console-pp-cli (outliers / quick-wins / cannibalization), google-developer-knowledge, and Chrome/image inspection tools.
    • Use Semrush/GSC CTR & keyword intelligence when available to select high-impression titles, brand transliterations, typos, and community names instead of guessing boilerplate labels.
    • Mandatory Fallback: Whenever Semrush, Exa, Tavily, or 1Password keys are absent, locked, or return quota/auth errors, fall back immediately to native web search (search_web / built-in search), live curl -A 'Googlebot/2.1', and local image/DOM inspection. Never stall on a missing external tool.
  • Full Population Sweep (Address All Similar Instances): Use rg across code and bounded DB queries (WHERE status='published') across CMS/landing tables so sibling routes, locales, and district hubs receive consistent metadata and <h1> fixes while archived/deleted rows remain untouched.
  • Hand-off boundaries: This skill owns <head> metadata, H1 parity, OG/Twitter tags, favicons, and visual social assets. Hand off broad technical crawls/backlinks to seo-audit, live Google Ads campaigns to google-ads-paid-acquisition-skill, and deep PostHog/DB/GA4 telemetry to analytics-db-posthog-etc-audit-skill.

1. SSR ↔ Client Hydration & Metadata Evaluation

Installs
3
First Seen
Aug 24, 2026