signals-scout-product-analytics — Claude Code skill: what it does
signals-scout-product-analytics — a skill for Claude Code and Codex monitoring core product analytics flows in PostHog. Detects derived-rate regressions across funnels and retention while entrant volume holds steady.
no license 204 installs ★ 101 updated 2026-11-16
npx skills add PostHog/ai-plugin --skill signals-scout-product-analytics -a claude-codeWhat signals-scout-product-analytics does
This scout inspects saved funnels, retention curves, lifecycle stages, stickiness, and paths in PostHog. It flags drops in calculated conversion percentages or retention rates against historical, seasonality-adjusted baselines. The core discriminator requires entrant volume to remain stable: when entry counts drop alongside conversion, the scout treats it as an event capture issue and hands it off without reporting.
The agent creates and revises entries directly via scout-emit-report and scout-edit-report. If no saved insights exist and top_events lists fewer than three discrete business events topping 100 hits daily, it writes a no-flow record. Future runs then rely on lightweight checks with scheduled reassessment dates set at 7, 14, or 28 days.
Operation requires a Claude sandbox equipped with PostHog MCP tools, specifically signal_scout_internal:write, signal_scout_report:write, execute-sql, read-data-schema, and the dedicated flow query utilities. The scout avoids whole-project scanning in a single execution, managing workloads via a persistent watchlist and an explore-exploit split.
What it helps with
- detect conversion regressions across activation funnels with steady entrants
- surface sliding week-1 retention curves before scheduled reviews
- catch lifecycle shifts toward dormant states
- distinguish ingestion volume drops from true behavioral declines
Example prompts for the agent
- Check our PostHog activation funnels for conversion drops
- Inspect saved retention insights for regressions using signals-scout-product-analytics
- Run product analytics scout to review recent lifecycle and stickiness trends
How to install signals-scout-product-analytics
1Skills CLI (Vercel)
npx skills add PostHog/ai-plugin --skill signals-scout-product-analytics -a claude-code2Manually: put the files in place
~/.claude/skills/signals-scout-product-analytics/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/signals-scout-product-analytics/
1Skills CLI (Vercel)
npx skills add PostHog/ai-plugin --skill signals-scout-product-analytics -a codex2Manually: put the files in place
.agents/skills/signals-scout-product-analytics/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add PostHog/ai-plugin --skill signals-scout-product-analytics -a cursor2Manually: put the files in place
.cursor/skills/signals-scout-product-analytics/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install PostHog/ai-plugin skills/signals-scout-product-analytics2Manually: put the files in place
.github/skills/signals-scout-product-analytics/SKILL.md1Skills CLI (Vercel)
npx skills add PostHog/ai-plugin --skill signals-scout-product-analytics -a gemini-cli2Platform CLI
gemini skills install https://github.com/PostHog/ai-plugin --path skills/signals-scout-product-analyticsManually: put the files in place
.devin/skills/signals-scout-product-analytics/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add PostHog/ai-plugin --skill signals-scout-product-analytics -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-product-analytics
How to install signals-scout-product-analytics in Claude Code?
Run npx skills add PostHog/ai-plugin --skill signals-scout-product-analytics -a claude-code. The definition will be placed in ~/.claude/skills/signals-scout-product-analytics/SKILL.md.
What does signals-scout-product-analytics do?
It monitors PostHog funnels, retention, and paths to detect behavioral rate regressions when baseline entrant counts remain unchanged.
What is required to run signals-scout-product-analytics?
It requires a Claude sandbox configured with the signals-scout MCP tools, write permissions for signal_scout_internal and signal_scout_report, along with SQL and analytics query access.