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
npx skills add travisjneuman/.claude --skill seo-analytics-auditor -a claude-codeWhat 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-code2Manually: put the files in place
~/.claude/skills/seo-analytics-auditor/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/seo-analytics-auditor/
1Skills CLI (Vercel)
npx skills add travisjneuman/.claude --skill seo-analytics-auditor -a codex2Manually: put the files in place
.agents/skills/seo-analytics-auditor/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add travisjneuman/.claude --skill seo-analytics-auditor -a cursor2Manually: put the files in place
.cursor/skills/seo-analytics-auditor/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install travisjneuman/.claude skills/seo-analytics-auditor2Manually: put the files in place
.github/skills/seo-analytics-auditor/SKILL.md1Skills CLI (Vercel)
npx skills add travisjneuman/.claude --skill seo-analytics-auditor -a gemini-cli2Platform CLI
gemini skills install https://github.com/travisjneuman/.claude --path skills/seo-analytics-auditorManually: put the files in place
.devin/skills/seo-analytics-auditor/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add travisjneuman/.claude --skill seo-analytics-auditor -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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