cwv-audit — Claude Code skill: Core Web Vitals audit and setup
A reference skill for Core Web Vitals: LCP, INP and CLS thresholds, common root causes and concrete fixes. Invoke it with /cwv-audit plus a metric or topic.
no license ★ 116 updated 2026-10-12
npx skills add cognyai/claude-code-marketing-skills --skill cwv-audit -a claude-codeWhat cwv-audit does
Inside is a technical reference covering the three Google vitals: what usually drives bad LCP, INP and CLS scores and how to fix them, plus CrUX BigQuery queries and setup steps for the web-vitals library. An argument narrows the answer — /cwv-audit CLS digs into layout shifts only, /cwv-audit monitoring covers the GA4 and BigQuery monitoring setup.
For real-site data the skill has several paths. With no accounts it calls the PageSpeed Insights API through curl, though keyless calls often hit HTTP 429, so you need a free Google Cloud API key with the PageSpeed Insights and Chrome UX Report APIs enabled. With Cogny MCP connected it pulls RUM data from GA4, traffic weighting from Search Console and dead-click signals from Microsoft Clarity, which allows only 10 requests per project per day.
When field data is unavailable the skill labels results as lab instead of guessing: a curl-only checklist flags TTFB above 0.8 s, render-blocking scripts in <head>, JPEG/PNG heroes without WebP/AVIF and <img> tags missing dimensions.
What it helps with
- diagnose a poor LCP, INP or CLS score down to its cause
- pull p75 field data per URL via CrUX and PageSpeed Insights
- write CrUX BigQuery queries for competitor comparison
- set up CWV monitoring with GA4 and the web-vitals library
- audit a page without a browser: TTFB, render-blocking assets, JS/CSS weight
Example prompts for the agent
- /cwv-audit INP — break down why the checkout page feels unresponsive
- /cwv-audit CrUX competitor — give me the comparison queries
- /cwv-audit monitoring — set up GA4 and BigQuery tracking
How to install cwv-audit
1Skills CLI (Vercel)
npx skills add cognyai/claude-code-marketing-skills --skill cwv-audit -a claude-code2Manually: put the files in place
~/.claude/skills/cwv-audit/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/cwv-audit/
1Skills CLI (Vercel)
npx skills add cognyai/claude-code-marketing-skills --skill cwv-audit -a codex2Manually: put the files in place
.agents/skills/cwv-audit/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add cognyai/claude-code-marketing-skills --skill cwv-audit -a cursor2Manually: put the files in place
.cursor/skills/cwv-audit/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install cognyai/claude-code-marketing-skills skills/cwv-audit2Manually: put the files in place
.github/skills/cwv-audit/SKILL.md1Skills CLI (Vercel)
npx skills add cognyai/claude-code-marketing-skills --skill cwv-audit -a gemini-cli2Platform CLI
gemini skills install https://github.com/cognyai/claude-code-marketing-skills --path skills/cwv-auditManually: put the files in place
.devin/skills/cwv-audit/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add cognyai/claude-code-marketing-skills --skill cwv-audit -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 cwv-audit
How do I install cwv-audit in Claude Code?
Run npx skills add cognyai/claude-code-marketing-skills --skill cwv-audit -a claude-code. The skill lands in ~/.claude/skills/cwv-audit/SKILL.md.
What does cwv-audit do?
It is a Core Web Vitals reference: LCP, INP and CLS thresholds, likely causes, fixes, CrUX BigQuery queries and web-vitals library setup. Passing an argument like /cwv-audit LCP focuses it on one metric.
Does cwv-audit need Google accounts to work?
No — the reference and the curl-only lab checklist work without accounts. Field data from CrUX needs a free Google Cloud API key, and GA4 or Search Console data requires a connected Cogny MCP.