signals-scout-apm — скилл для Claude Code: что делает и как установить
Скилл signals-scout-apm ловит регрессии в трассировках PostHog: доля ошибок и p95 по сервисам, новые сигнатуры ошибок, обрывы трафика. Отчёт пишет, только когда сдвиг подтверждён.
лицензия не указана 202 установок ★ 101 обновлён 2026-11-16
npx skills add PostHog/ai-plugin --skill signals-scout-apm -a claude-codeЧто делает signals-scout-apm
Скилл смотрит на спаны OpenTelemetry в PostHog и ищет регрессии по каждой операции внутри сервиса. Считает долю ошибок и p95, сравнивает с тем же окном неделю назад. Сигналом считает рост доли, а не абсолютного числа: всплеск ошибок вместе с всплеском трафика — это объём, а не поломка.
Отчёт скилл пишет сам через канал отчётов (emit_report, edit_report). Если регрессия уже в инбоксе и продолжает двигаться, он правит существующий отчёт, а не заводит новый. Второй режим — постоянные издержки: N+1, тяжёлые запросы, кандидаты на кеш. Его включают, только когда первый канал молчит, и паттерн должен быть виден и сейчас, и неделю назад на живой трассе.
Работает внутри PostHog Signals agent в песочнице Claude: нужны доступ на чтение аналитики, запись в scratchpad и канал отчётов, семейство инструментов apm-* и вложенный скилл exploring-apm-traces. Без спанов в проекте прогон закрывается пустым: скилл проверяет apm-services-list и число спанов за сутки, оставляет заметку в scratchpad и дальше не идёт. События $ai_* и поток логов он не трогает, потому что это чужая территория.
Какие задачи решает
- поймать рост доли ошибок на операции после выката
- сравнить p95 задержки с тем же окном неделю назад
- отличить настоящую регрессию от всплеска трафика
- найти сигнатуры ошибок, которых у сервиса раньше не было
- выписать операции с N+1 и дорогими запросами под кеш
Примеры запросов агенту
- Прогони APM-скаут за последние сутки и сравни с прошлой неделей: есть ли регрессии по ошибкам или p95?
- Проверь трассировки за сутки на новые сигнатуры ошибок и обрывы трафика по сервисам
- Покажи операции, где N+1 или тяжёлые запросы тянутся и сейчас, и неделю назад
Как установить signals-scout-apm
1Через Skills CLI (Vercel)
npx skills add PostHog/ai-plugin --skill signals-scout-apm -a claude-code2Вручную: положить файлы
~/.claude/skills/signals-scout-apm/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/signals-scout-apm/
1Через Skills CLI (Vercel)
npx skills add PostHog/ai-plugin --skill signals-scout-apm -a codex2Вручную: положить файлы
.agents/skills/signals-scout-apm/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add PostHog/ai-plugin --skill signals-scout-apm -a cursor2Вручную: положить файлы
.cursor/skills/signals-scout-apm/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install PostHog/ai-plugin skills/signals-scout-apm2Вручную: положить файлы
.github/skills/signals-scout-apm/SKILL.md1Через Skills CLI (Vercel)
npx skills add PostHog/ai-plugin --skill signals-scout-apm -a gemini-cli2Командой платформы
gemini skills install https://github.com/PostHog/ai-plugin --path skills/signals-scout-apmВручную: положить файлы
.devin/skills/signals-scout-apm/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add PostHog/ai-plugin --skill signals-scout-apm -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о signals-scout-apm
Как установить signals-scout-apm в Claude Code?
Выполните npx skills add PostHog/ai-plugin --skill signals-scout-apm -a claude-code. Файл скилла появится по пути ~/.claude/skills/signals-scout-apm/SKILL.md.
Что делает signals-scout-apm?
Сравнивает долю ошибок и p95 по операциям сервисов с базой недельной давности, ищет новые сигнатуры ошибок и падения трафика. Отдельно аудирует постоянные издержки: N+1, тяжёлые запросы, кандидатов на кеширование.
Что нужно, чтобы скилл заработал?
PostHog Signals agent в песочнице Claude, доступ на чтение аналитики, запись в scratchpad и канал отчётов, инструменты apm-* и вложенный скилл exploring-apm-traces. Если в проекте нет спанов, прогон заканчивается пустым отчётом.