# signals-scout-apm

signals-scout-apm watches OpenTelemetry traces in PostHog for error-rate and latency shifts per service, new error signatures and traffic drops, and files a report only on a confirmed change.

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

## What it does

The skill reads spans stored in PostHog and scores each operation against the same window seven days earlier. Error share and p95 latency are the signal; a raw count that grows alongside traffic is not. When both numbers climb together, that is volume.

Reports go out through the report channel itself (`emit_report`, `edit_report`). A regression the inbox already tracks and that is still moving gets edited rather than filed again. There is a second, quieter lane for standing waste: repeated N+1 calls, costly query shapes, spots that would benefit from caching. It runs only while the regression lane is quiet, and the pattern has to show up both now and a week ago on a sampled trace.

Everything happens inside the PostHog Signals agent sandbox: read access to analytics, write access to the scratchpad and report channel, the `apm-*` tool family and the bundled `exploring-apm-traces` skill. A project without spans ends the run early, since the scout checks `apm-services-list` and the 24-hour span count first and leaves a scratchpad note for later runs. `$ai_*` events and the logs stream belong to other scouts and stay untouched.

## Install

### Claude Code (native platform)

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

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

### Codex

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

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

### Cursor

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

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

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

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

## When to use it
- catch an error-share jump on one operation after a deploy
- compare p95 latency with the same window a week back
- separate a real regression from a traffic spike
- surface error signatures the service never emitted before
- list N+1 calls and expensive queries worth caching

## Example prompts
- Run the APM scout over the last 24 hours against last week — any error or p95 regressions?
- Check the traces for new error signatures and traffic drops per service
- Show operations still doing N+1 calls or heavy queries that were already there a week ago

## Similar
- [exploring-apm-traces](https://affpapa.org/en/nevibecode/skills/exploring-apm-traces.md) — skill · 387 installs
- [signals-scout-ai-observability](https://affpapa.org/en/nevibecode/skills/signals-scout-ai-observability.md) — skill · 317 installs
- [dd-apm](https://affpapa.org/en/nevibecode/skills/dd-apm.md) — skill · 2200 installs
- [app-observability](https://affpapa.org/en/nevibecode/skills/app-observability.md) — skill · 4800 installs
- [observability-and-instrumentation](https://affpapa.org/en/nevibecode/skills/observability-and-instrumentation.md) — skill · 70700 installs
- [sentry-otel-exporter-setup](https://affpapa.org/en/nevibecode/skills/sentry-otel-exporter-setup.md) — skill · 2500 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
