Skip to main content
skill CX Codex

seo-analytics-auditor — Claude Code skill for SEO and analytics audits

seo-analytics-auditor — a skill that checks meta tags, structured data, analytics scripts and Core Web Vitals on a page. It reads the source HTML and walks through the SEO checklist item by item.

MIT 156 installs ★ 114 updated 2026-11-06

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add travisjneuman/.claude --skill seo-analytics-auditor -a claude-code
Open on GitHub

What seo-analytics-auditor does

The skill runs an SEO audit against a checklist: title and description, canonical, Open Graph, Twitter Card, Schema.org markup, robots.txt and sitemap.xml. It also checks how Google Analytics 4 and Cloudflare Web Analytics are wired in, and compares LCP, INP and CLS against the good / needs improvement / poor thresholds.

No local browser is started. The skill reads source and deployed HTML, and views rendered pages in the app's built-in browser or agent-browser. Lighthouse-style audits run only when the user asks, through the hosted PageSpeed Insights API or Search Console reports.

Inside there is a Core Web Vitals threshold table, a cheat sheet for common issues such as a short description or wrong OG image size, and pointers to PageSpeed Insights, Rich Results Test and OpenGraph.xyz.

What it helps with

  • check title, description, canonical and robots tags
  • spot errors in Schema.org and Open Graph markup
  • compare LCP, INP and CLS values against thresholds
  • verify GA4 and Cloudflare Web Analytics setup
  • walk through the robots.txt and sitemap.xml checklist

Example prompts for the agent

  • Audit SEO markup on the index.html page
  • Check Core Web Vitals against the skill's thresholds
  • Find issues in the GA4 and Cloudflare Web Analytics setup

How to install seo-analytics-auditor

1Skills CLI (Vercel)

npx skills add travisjneuman/.claude --skill seo-analytics-auditor -a claude-code

2Manually: put the files in place

~/.claude/skills/seo-analytics-auditor/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/seo-analytics-auditor/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about seo-analytics-auditor

How do I install seo-analytics-auditor in Claude Code?

Run npx skills add travisjneuman/.claude --skill seo-analytics-auditor -a claude-code, then the skill lives at ~/.claude/skills/seo-analytics-auditor/SKILL.md.

What does seo-analytics-auditor do?

It audits SEO markup, structured data and analytics wiring. It checks meta tags, Open Graph, Schema.org, GA4, Cloudflare Web Analytics and Core Web Vitals.

Does the skill run Lighthouse locally?

No local browser is launched. Lighthouse-style audits go through the hosted PageSpeed Insights API or Search Console reports, and only when explicitly requested.

Source text

SKILL.md · MIT
---
name: seo-analytics-auditor
description: Use this skill when auditing SEO, analyzing Core Web Vitals, verifying meta tags, checking structured data, or troubleshooting analytics implementations. Covers Google Search Console, Google Analytics 4, Cloudflare Web Analytics, and technical SEO best practices.
---

# 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         |
| ------------------ | ------------------------------------------- | --------------- |
| PageSpeed Insights | https://pagespeed.web.dev                   | Core Web Vitals |
| Rich Results Test  | https://search.google.com/test/rich-results | Schema.org      |
| OpenGraph.xyz      | https://www.opengraph.xyz                   | Social preview  |

## Files to Check

- `index.html` - Meta tags, analytics scripts, Schema.org
- `robots.txt` - Crawler directives, sitemap reference
- `sitemap.xml` - URL list, lastmod dates
- `manifest.json` - PWA config

## Common Issues

| Issue                      | Fix                              |
| -------------------------- | -------------------------------- |
| Meta description too short | Use 150-160 characters           |
| Missing canonical URL      | Add `<link rel="canonical">`     |
| OG image wrong size        | Use 1200x630 for best display    |
| Schema.org errors          | Test with Rich Results Test      |
| Analytics not firing       | Check browser console for errors |

## Integration Checklist

- [ ] Google Search Console verified
- [ ] Sitemap submitted to GSC
- [ ] GA4 property created and linked
- [ ] Core Web Vitals in "Good" range
- [ ] Rich Results test passing
- [ ] Social preview working

## See Also

- [Google SEO Starter Guide](https://developers.google.com/search/docs/fundamentals/seo-starter-guide)
- [Core Web Vitals](https://web.dev/articles/vitals)
- [Schema.org](https://schema.org/docs/gs.html)

© travisjneuman · MIT · travisjneuman/.claude

Similar skills

All skills for SEO and GEO →

From the same set117

The whole set →
debate-practice-coach The debate-practice-coach skill for Claude Code structures arguments with the Toulmin model, helps build counterarguments, and flags logical fallacies. CX Codex +1 157installs rd-management This skill gives an agent R&D management frameworks for portfolios, technology roadmaps, research programs, and patent planning. CX Codex +1 157installs react-native This Claude Code skill supports React Native and Expo work on iOS and Android apps. It activates for JavaScript or TypeScript projects involving native features or mobile performance. CX Codex +1 157installs generic-fullstack-code-reviewer generic-fullstack-code-reviewer is a Claude Code skill for reviewing full-stack changes before commits and during pull request reviews. It checks Next.js and NestJS code for bugs, security issues, and project-rule mismatches. CX Codex +1 157installs financial-scenario-planner financial-scenario-planner runs a financial plan through bear, base and bull cases, then adds sensitivity tables, break-even and a runway check. Useful when the assumptions behind a model need testing. CX Codex +1 156installs product-management product-management equips your agent with product strategy frameworks: RICE scoring, roadmap horizons, OKR setups, and PMF validation surveys. CX Codex +1 153installs agent-teams Teaches Claude how to compose agent teams: which tasks split well, how many teammates to spawn, and what goes into each spawn prompt. Active only once teams are enabled. CX Codex +1 153installs generic-fullstack-ux-designer generic-fullstack-ux-designer is a Claude Code skill that guides UX design for Next.js and NestJS apps, covering loading states, optimistic UI, forms, and SSR quirks. CX Codex +1 153installs

Project sponsors

Companies that keep this analytics open