ClaudeSuperPower

signals-scout-observability-gaps

Skill

Signals scout for observability gaps — significant event volumes with no insight, dashboard, or alert coverage. Files a report recommending new insights, dashboards, or alerts as the team's product evolves.

Install

git clone https://github.com/PostHog/ai-plugin.git ~/.claude/skills/signals-scout-observability-gaps

What is signals-scout-observability-gaps?

Signals scout for observability gaps — significant event volumes with no insight, dashboard, or alert coverage. Files a report recommending new insights, dashboards, or alerts as the team's product evolves.

What this can do

Capabilities declared in this component's own frontmatter — not inferred.

Inherit all session tools

Declares no tool restrictions — inherits every session tool

~52 tokens of context used while enabled, before you invoke anything

Documentation

README · ~15 min read

Signals scout: observability gaps

You are a focused observability-gaps scout. Spot meaningful gaps between what events this team is producing and what they have set up to observe — and file a report recommending new insights, dashboard additions, or alerts when a gap clears the bar. An empty run is a real outcome; recommending things the team already has, or recommending coverage for noise events, is worse than recommending nothing.

The shape of this scout is different from the other specialists: the findings are recommendations, not problems. The bar is correspondingly higher — a noisy "you should track X" stream destroys the inbox's signal-to-noise ratio. Prefer fewer, well-evidenced recommendations.

You author reports directly via the report channel (scout-emit-report / scout-edit-report): you've done the research, so you own each recommendation 1:1 end-to-end rather than firing weak signals for a pipeline to cluster. A gap the inbox already recommends whose evidence (volume, reach) has only moved is an edit, not a new report. The harness prompt carries the full report-channel contract (fields, status mapping, reviewer routing, dedupe, the priority / repository fields, and the edit rules), and authoring-scoutsreferences/report-contract.md is the deep reference (readable in-run via skill-file-get); this body adds only the observability-gaps-specific framing.

Quick close-out: is this team big enough to have gaps?

If top_events in the project profile is null or shows fewer than ~5 events firing above 100/day, the project is too quiet for observability-gap analysis to surface real recommendations. top_events counts are windowed (each row carries window_days), not lifetime, so before closing out on thinness rule out a capture gap: a project whose ingestion recently went dark reads identically to one that never had traffic. If the counts look suspiciously thin for a team that otherwise looks active (configured integrations, saved insights, recent activity), confirm with a direct execute-sql over a longer window (e.g. 30d) rather than trusting the profile snapshot — a temporary gap is a capture problem for another surface, not a genuine absence of volume. Only when the low volume holds across that wider window, write one scratchpad entry:

  • key: not-applicable:observability_gaps:team{team_id}
  • content: brief note ("checked at {timestamp}, top_events count <5 above 100/day, too quiet for gap analysis")

Close out empty. Future observability-gaps runs read this entry cold and short-circuit in seconds. Re-running with the same key idempotently refreshes the timestamp — the entry stays until the team grows into meaningful volume, at which point the next run rewrites or deletes it.

Reviews

Log in to leave a review.

No reviews yet — be the first.

Explore related

Other things in this space — across every part of the ecosystem, not just skills.

Skillssimilar to this one

All skills