signals-scout-insight-alerts — Claude Code skill: setup
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.
no license 195 installs ★ 101 updated 2026-11-10
npx skills add PostHog/ai-plugin --skill signals-scout-insight-alerts -a claude-codeWhat signals-scout-insight-alerts does
Operating inside the PostHog Signals agent environment, it evaluates threshold and anomaly alerts created by the team. The agent retrieves rules via alerts-list, ignores disabled or snoozed checks, and inspects candidate breaches using alert-get across the selected lookback window.
Triage focuses on whether team members were actually notified. Breaches with missing subscriber targets, blank notification timestamps, or automated suppression receive immediate attention. In contrast, quick metric flaps that resolve themselves within a single check interval are categorized as noise.
The routine depends on specific MCP functions: alerts-list, alert-get, and insight-get, alongside write access to emit_report and edit_report. If the workspace has zero active insight alerts configured, the scout records an empty baseline and terminates without filing reports.
What it helps with
- surface PostHog metric breaches that failed to dispatch notifications
- spot silently failing alert monitors stuck in an error state
- separate short-lived metric flaps from persistent threshold violations
- generate triage reports for unhandled insight notifications
Example prompts for the agent
- Check recent PostHog insight alerts and surface firings that missed notification
- Run a digest on active alert breaches over the last 24 hours
- Find any PostHog monitors currently in an Errored state
How to install signals-scout-insight-alerts
1Skills CLI (Vercel)
npx skills add PostHog/ai-plugin --skill signals-scout-insight-alerts -a claude-code2Manually: put the files in place
~/.claude/skills/signals-scout-insight-alerts/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/signals-scout-insight-alerts/
1Skills CLI (Vercel)
npx skills add PostHog/ai-plugin --skill signals-scout-insight-alerts -a codex2Manually: put the files in place
.agents/skills/signals-scout-insight-alerts/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add PostHog/ai-plugin --skill signals-scout-insight-alerts -a cursor2Manually: put the files in place
.cursor/skills/signals-scout-insight-alerts/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install PostHog/ai-plugin skills/signals-scout-insight-alerts2Manually: put the files in place
.github/skills/signals-scout-insight-alerts/SKILL.md1Skills CLI (Vercel)
npx skills add PostHog/ai-plugin --skill signals-scout-insight-alerts -a gemini-cli2Platform CLI
gemini skills install https://github.com/PostHog/ai-plugin --path skills/signals-scout-insight-alertsManually: put the files in place
.devin/skills/signals-scout-insight-alerts/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add PostHog/ai-plugin --skill signals-scout-insight-alerts -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-insight-alerts
How to install signals-scout-insight-alerts in Claude Code?
Run npx skills add PostHog/ai-plugin --skill signals-scout-insight-alerts -a claude-code. The command configures ~/.claude/skills/signals-scout-insight-alerts/SKILL.md.
What does signals-scout-insight-alerts do?
It evaluates firing logs from configured PostHog alerts to pinpoint incidents engineers likely missed. Meaningful breaches are filed or updated using emit_report and edit_report.
Which MCP tools are required by this skill?
It needs read access to alerts-list, alert-get, and insight-get, plus permissions to run emit_report and edit_report.