# cwv-audit

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.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · ★ 116 repo stars
- Author: Cogny AI
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/cognyai/claude-code-marketing-skills/tree/HEAD/skills/cwv-audit/SKILL.md
- Updated: 2026-10-12
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/cwv-audit

## What it 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.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add cognyai/claude-code-marketing-skills --skill cwv-audit -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/cwv-audit/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/cwv-audit/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add cognyai/claude-code-marketing-skills --skill cwv-audit -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/cwv-audit/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add cognyai/claude-code-marketing-skills --skill cwv-audit -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/cwv-audit/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install cognyai/claude-code-marketing-skills skills/cwv-audit
```

2. **Manually: put the files in place**
- File: `.github/skills/cwv-audit/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add cognyai/claude-code-marketing-skills --skill cwv-audit -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/cognyai/claude-code-marketing-skills --path skills/cwv-audit
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/cwv-audit/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add cognyai/claude-code-marketing-skills --skill cwv-audit -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/cognyai/claude-code-marketing-skills/tree/HEAD/skills/cwv-audit/SKILL.md

## When to use it
- 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
- /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

## Similar
- [web-quality-audit](https://affpapa.org/en/nevibecode/skills/web-quality-skills-web-quality-audit.md) — skill · 38800 installs
- [audit-speed](https://affpapa.org/en/nevibecode/skills/audit-speed.md) — skill · 2400 installs
- [web-performance-audit](https://affpapa.org/en/nevibecode/skills/web-performance-audit.md) — skill · 550 installs
- [seo-google](https://affpapa.org/en/nevibecode/agents/seo-google.md) — subagent · ★ 159 repo stars
- [core-web-vitals-tuner](https://affpapa.org/en/nevibecode/skills/core-web-vitals-tuner.md) — skill · 322 installs
- [core-web-vitals](https://affpapa.org/en/nevibecode/skills/kostja94-core-web-vitals.md) — skill · 1200 installs

From the same set: [cognyai/claude-code-marketing-skills](https://affpapa.org/en/nevibecode/by/cognyai/claude-code-marketing-skills.md) — 60 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
