Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add PostHog/ai-plugin --skill signals-scout-web-vitals -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/signals-scout-web-vitals/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/signals-scout-web-vitals/

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.

Similar skills

All skills for Frontend and UI →

From the same set82

The whole set →
creating-online-evaluations creating-online-evaluations — a Claude Code skill that turns production failure modes into continuously-running online evaluations in PostHog. It starts when new generations need automatic scoring against specific errors. CX Codex +1 195installs signals-scout-insight-alerts signals-scout-insight-alerts — a Claude Code skill for reviewing insight alert history in PostHog. It scans recent alert triggers and flags material incidents that missed notifying the team. CX Codex +1 195installs signals-scout-data-warehouse signals-scout-data-warehouse monitors warehouse imports for failures, stale data, and sharp row-count drops, then flags recurring query patterns that may merit materialized views. CX Codex +1 195installs signals-scout-mcp-tool-calls signals-scout-mcp-tool-calls — a PostHog Signals skill that sifts $mcp_tool_call telemetry for MCP tools agents struggle with, then files one report per product category. CX Codex +1 194installs signals-scout-skills-store signals-scout-skills-store audits shared PostHog agent skills for vague descriptions, oversized bodies, broken links, and leaked secrets. Produces reports with copy-ready fixes. CX Codex +1 193installs analyzing-expensive-users analyzing-expensive-users — a skill for Claude Code, Codex, Cursor and other agents that finds the top spenders in PostHog AI observability and explains what drives their costs. CX Codex +1 192installs turning-engineering-analytics-into-insights turning-engineering-analytics-into-insights — a skill for Claude Code and Codex: converts PR and CI metrics into saved PostHog insights, dashboards, and automated subscriptions. Triggers when visualizing engineering team performance. CX Codex +1 189installs investigating-logs The investigating-logs Claude Code skill investigates logs in a PostHog project, checks service health and traces error spikes. It runs for deploy checks, incident triage, change analysis, or a search around one trace or run. CX Codex +1 188installs

Project sponsors

Companies that keep this analytics open