seo-analytics-auditor

Files (1)

• SKILL.md

SKILL.md (first lines)

# SEO & Analytics Auditor

Audit SEO, verify analytics, and optimize Core Web Vitals.

## When to Use

**Use for:**

- Auditing SEO meta tags and structured data
- Verifying analytics implementations (GA4, Cloudflare)
- Checking Core Web Vitals (LCP, INP, CLS)
- Troubleshooting Search Console issues
- Validating Open Graph and Twitter Card meta tags
- Reviewing robots.txt and sitemap.xml

## Quick Audit Workflow

Local browser automation (`npx lighthouse`, Playwright, Puppeteer, Selenium/WebDriver, headless Chrome from a shell) is not installed or run. Start from reading the source, meta tags, and deployed HTML; view rendered pages in the active app's built-in browser (then `agent-browser`). Run Lighthouse-style audits only when the user asks, through a hosted lane such as PageSpeed Insights or the Search Console reports.

```bash
# 1. Lighthouse audit via the hosted PageSpeed Insights API (no local browser)
curl -s "https://www.googleapis.com/pagespeedonline/v5/runPagespeed?url=https://yoursite.com&category=seo&category=performance&strategy=mobile"

# 2. Check Core Web Vitals field data
# Open: https://pagespeed.web.dev/ or the Search Console Core Web Vitals report

# 3. Validate structured data
# Open: https://search.google.com/test/rich-results
```

## SEO Checklist

### Meta Tags (Required)

```html
<title>Page Title - Brand (50-60 chars)</title>
<meta name="description" content="Description (150-160 chars)" />
<meta name="robots" content="index, follow" />
<link rel="canonical" href="https://domain.com/page/" />
```

### Open Graph (Social Sharing)

```html
<meta property="og:type" content="website" />
<meta property="og:url" content="https://domain.com/" />
<meta property="og:title" content="Title" />
<meta property="og:description" content="Description" />
<meta property="og:image" content="https://domain.com/og-image.png" />
<meta property="og:image:width" content="1200" />
<meta property="og:image:height" content="630" />
```

### Twitter Card

```html
<meta name="twitter:card" content="summary_large_image" />
<meta name="twitter:title" content="Title" />
<meta name="twitter:description" content="Description" />
<meta name="twitter:image" content="https://domain.com/og-image.png" />
```

### Schema.org (Structured Data)

```html
<script type="application/ld+json">
  {
    "@context": "https://schema.org",
    "@type": "Person",
    "name": "Name",
    "jobTitle": "Title",
    "url": "https://domain.com"
  }
</script>
```

## Analytics Implementation

### Google Analytics 4

```html
<script
  async
  src="https://www.googletagmanager.com/gtag/js?id=G-XXXXXXXXXX"
></script>
<script>
  window.dataLayer = window.dataLayer || [];
  function gtag() {
    dataLayer.push(arguments);
  }
  gtag("js", new Date());
  gtag("config", "G-XXXXXXXXXX", {
    anonymize_ip: true,
    cookie_flags: "SameSite=None;Secure",
  });
</script>
```

### Cloudflare Web Analytics

```html
<script
  defer
  src="https://static.cloudflareinsights.com/beacon.min.js"
  data-cf-beacon='{"token": "YOUR_TOKEN"}'
></script>
```

## Core Web Vitals Targets (2025)

| 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  |

## Testing Tools

| Tool               | URL                                         | Purpose         |

From travisjneuman/.claude, MIT.

More from travisjneuman/.claude