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

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 195 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-insight-alerts/SKILL.md
- Updated: 2026-11-10
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/signals-scout-insight-alerts

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

## Install

### Claude Code (native platform)

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

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

### Codex

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

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

### Cursor

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

2. **Manually: put the files in place**
- File: `.cursor/skills/signals-scout-insight-alerts/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-insight-alerts
```

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

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

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

## Similar
- [signals-scout-observability-gaps](https://affpapa.org/en/nevibecode/skills/signals-scout-observability-gaps.md) — skill · 316 installs
- [signals-scout-feature-flags](https://affpapa.org/en/nevibecode/skills/signals-scout-feature-flags.md) — skill · 318 installs
- [cx-alerts](https://affpapa.org/en/nevibecode/skills/cx-alerts.md) — skill · 4700 installs
- [nansen-smart-alerts](https://affpapa.org/en/nevibecode/skills/nansen-smart-alerts.md) — skill · 401 installs
- [posthog-cost-tuning](https://affpapa.org/en/nevibecode/skills/posthog-cost-tuning.md) — skill · 1 install
- [ctx-insight](https://affpapa.org/en/nevibecode/skills/ctx-insight.md) — skill · 1500 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
