# signals-scout-web-vitals

signals-scout-web-vitals tracks page p75 LCP, INP, CLS, and FCP from PostHog events, spots performance degradation against Google thresholds, and links regressions to deploys.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 194 installs · ★ 101 repo stars
- Author: PostHog
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/PostHog/ai-plugin/tree/HEAD/skills/signals-scout-web-vitals/SKILL.md
- Updated: 2026-11-16
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/signals-scout-web-vitals

## What it does

The skill inspects Core Web Vitals telemetry inside PostHog's `events` table. It computes 75th percentile values for LCP, INP, CLS, and FCP routes. Instead of looking solely at sudden drops, it checks values against Google thresholds. When a route sits in the poor band or slips into a worse category, the scout creates a direct finding with probable causes and suggested remediation.

Regressions get linked to recent deployments or feature flag changes using activity logs. To guard against prompt injection through public capture tokens, SQL queries sanitize `$host` and `$pathname` properties before values enter the prompt context.

The scout requires PostHog MCP scopes: read-only analytics along with `signal_scout_internal:write` and `signal_scout_report:write`. Without `capture_performance` enabled in your PostHog SDK, no `$web_vitals` events reach the database.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add PostHog/ai-plugin --skill signals-scout-web-vitals -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add PostHog/ai-plugin --skill signals-scout-web-vitals -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add PostHog/ai-plugin --skill signals-scout-web-vitals -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install PostHog/ai-plugin skills/signals-scout-web-vitals
```

2. **Manually: put the files in place**
- File: `.github/skills/signals-scout-web-vitals/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add PostHog/ai-plugin --skill signals-scout-web-vitals -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/PostHog/ai-plugin --path skills/signals-scout-web-vitals
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add PostHog/ai-plugin --skill signals-scout-web-vitals -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/PostHog/ai-plugin/tree/HEAD/skills/signals-scout-web-vitals/SKILL.md

## When to use it
- identify pages stuck in poor LCP, INP, CLS, or FCP thresholds
- tie frontend performance regressions to specific deploys or flag rollouts
- sanitize route names in analytical SQL to prevent prompt injection
- compile actionable web vitals reports with remediation steps

## Example prompts
- Check Core Web Vitals trends over the last 7 days in PostHog
- Find pages where p75 LCP regressed after yesterday's release
- Generate a report for routes with poor INP scores and suggest fixes

## Similar
- [signals-scout-anomaly-detection](https://affpapa.org/en/nevibecode/skills/signals-scout-anomaly-detection.md) — skill · 318 installs
- [signals-scout-web-analytics](https://affpapa.org/en/nevibecode/skills/signals-scout-web-analytics.md) — skill · 317 installs
- [performance-and-web-vitals](https://affpapa.org/en/nevibecode/skills/performance-and-web-vitals.md) — skill · 1200 installs
- [core-web-vitals](https://affpapa.org/en/nevibecode/rules/core-web-vitals.md) — rule · ★ 4719 repo stars
- [core-web-vitals-tuner](https://affpapa.org/en/nevibecode/skills/core-web-vitals-tuner.md) — skill · 322 installs
- [web-perf](https://affpapa.org/en/nevibecode/skills/cloudflare-web-perf.md) — skill · 129400 installs

From the same set: [posthog/ai-plugin](https://affpapa.org/en/nevibecode/by/posthog/ai-plugin.md) — 82 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
