signals-scout-web-vitals — Claude Code skill: features and install
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.
no license 194 installs ★ 101 updated 2026-11-16
npx skills add PostHog/ai-plugin --skill signals-scout-web-vitals -a claude-codeWhat signals-scout-web-vitals 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.
What it helps with
- 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 for the agent
- 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
How to install signals-scout-web-vitals
1Skills CLI (Vercel)
npx skills add PostHog/ai-plugin --skill signals-scout-web-vitals -a claude-code2Manually: put the files in place
~/.claude/skills/signals-scout-web-vitals/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/signals-scout-web-vitals/
1Skills CLI (Vercel)
npx skills add PostHog/ai-plugin --skill signals-scout-web-vitals -a codex2Manually: put the files in place
.agents/skills/signals-scout-web-vitals/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add PostHog/ai-plugin --skill signals-scout-web-vitals -a cursor2Manually: put the files in place
.cursor/skills/signals-scout-web-vitals/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install PostHog/ai-plugin skills/signals-scout-web-vitals2Manually: put the files in place
.github/skills/signals-scout-web-vitals/SKILL.md1Skills CLI (Vercel)
npx skills add PostHog/ai-plugin --skill signals-scout-web-vitals -a gemini-cli2Platform CLI
gemini skills install https://github.com/PostHog/ai-plugin --path skills/signals-scout-web-vitalsManually: put the files in place
.devin/skills/signals-scout-web-vitals/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add PostHog/ai-plugin --skill signals-scout-web-vitals -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 signals-scout-web-vitals
How to install signals-scout-web-vitals in Claude Code?
Run npx skills add PostHog/ai-plugin --skill signals-scout-web-vitals -a claude-code.
What does signals-scout-web-vitals do?
It queries $web_vitals events in PostHog, evaluates p75 values for LCP, INP, CLS, and FCP, and files reports linking slowdowns to deploys.
Which metrics are evaluated by this skill?
The scout checks LCP (poor threshold > 4000 ms), INP (> 500 ms), CLS (> 0.25), and FCP (> 3000 ms). It does not track TTFB because $web_vitals omits it.