signals-scout-apm — Claude Code skill: what it does, how to install
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.
no license 202 installs ★ 101 updated 2026-11-16
npx skills add PostHog/ai-plugin --skill signals-scout-apm -a claude-codeWhat signals-scout-apm 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.
What it helps with
- 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 for the agent
- 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
How to install signals-scout-apm
1Skills CLI (Vercel)
npx skills add PostHog/ai-plugin --skill signals-scout-apm -a claude-code2Manually: put the files in place
~/.claude/skills/signals-scout-apm/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/signals-scout-apm/
1Skills CLI (Vercel)
npx skills add PostHog/ai-plugin --skill signals-scout-apm -a codex2Manually: put the files in place
.agents/skills/signals-scout-apm/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add PostHog/ai-plugin --skill signals-scout-apm -a cursor2Manually: put the files in place
.cursor/skills/signals-scout-apm/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install PostHog/ai-plugin skills/signals-scout-apm2Manually: put the files in place
.github/skills/signals-scout-apm/SKILL.md1Skills CLI (Vercel)
npx skills add PostHog/ai-plugin --skill signals-scout-apm -a gemini-cli2Platform CLI
gemini skills install https://github.com/PostHog/ai-plugin --path skills/signals-scout-apmManually: put the files in place
.devin/skills/signals-scout-apm/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add PostHog/ai-plugin --skill signals-scout-apm -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-apm
How do I install signals-scout-apm in Claude Code?
Run npx skills add PostHog/ai-plugin --skill signals-scout-apm -a claude-code. The skill file lands at ~/.claude/skills/signals-scout-apm/SKILL.md.
What does signals-scout-apm do?
It tracks error share and p95 latency per operation against a baseline from a week earlier, flags fresh error signatures and traffic cliffs, and audits recurring N+1 calls, heavy queries and caching candidates.
What does the skill need in order to run?
The PostHog Signals agent sandbox, read access to analytics, write access to the scratchpad and report channel, the apm-* tools and the bundled exploring-apm-traces skill. With no spans in the project the run closes empty.