signals-scout-insight-alerts

Triages PostHog insight alert firing history to surface missed, material firings as inbox reports.

713|118|Updated Aug 11, 2020
One-click install
npx skills add https://github.com/PostHog/posthog-foss --skill signals-scout-insight-alerts
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: signals-scout-insight-alerts
Source: https://github.com/PostHog/posthog-foss/tree/main/products/signals/skills/signals-scout-insight-alerts
Command: npx skills add https://github.com/PostHog/posthog-foss --skill signals-scout-insight-alerts

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Teams configure insight alerts in PostHog but often miss firings when notifications fail, get suppressed, or no one is subscribed. This Skill reads each alert's recent firing history and surfaces the firings a human most likely missed, so silent breaches and broken alerts don't go unnoticed.

Core Features & Use Cases

  • Missed-firing triage: Ranks recent alert firings by missed-ness, materiality, and persistence to find under-notified breaches worth reporting.
  • Report authoring and editing: Files or updates inbox reports via the report channel, deduplicating against prior runs and existing reports so a persistent breach stays one report.
  • Noise suppression: Skips snoozed, disabled, flapping, already-notified, and dev/test alerts, recording scratchpad memory so future runs don't re-surface them.
  • Use Case: A daily run finds an alert that fired 3x past its threshold with no notification sent and is still firing; the Skill files a P1 report with the alert id, insight short_id, calculated value versus bound, and notification status as evidence.

Quick Start

Ask the agent to triage the project's configured insight alerts and report any recent firings the team likely missed.

Frequently Asked Questions about signals-scout-insight-alerts

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find PostHog alert firings that nobody was notified about?

List alerts with alerts-list, then pull firing history with alert-get and check for missing notification_sent_at, empty targets_notified, or notification_suppressed_by_agent. Firings with those markers are the highest-value missed signals to report.

How does the scout decide which alert firings are worth reporting?

It ranks each firing by missed-ness, materiality, and persistence. A material firing well past its threshold bound that was never notified or is still open and unacted clears the bar; marginal breaches and single flaps do not.

Does this skill detect anomalies in insight data?

No, it does not re-detect anomalies. It triages the firing history of alerts users already configured, since the team chose the thresholds themselves; anomaly scoring of viewed insights belongs to a separate sibling scout.

What happens when an alert keeps firing across multiple runs?

A persistent breach stays a single report. The scout edits the existing report with append_note containing the fresh firing's calculated value, fired-at time, and notification status instead of filing a duplicate.

Which alerts are excluded from triage?

Snoozed or disabled alerts, flapping alerts that fire and resolve within one interval, already-notified-and-resolved firings, marginal breaches on noisy series, dev or test environment alerts, and transient single-check errors are all skipped.

How many reports does a single run file at most?

At most about five reports per run, ranked worst-first by the triage discriminator. If more findings clear the bar, the close-out summary states how many were dropped rather than silently truncating them.