signals-scout-workflows — Claude Code skill: email analysis
The signals-scout-workflows Claude Code skill checks email-step metrics in PostHog workflows and drafts a change for review. It only examines workflows whose owners enabled suggestions.
no license 111 installs ★ 101 updated 2026-10-24
npx skills add PostHog/ai-plugin --skill signals-scout-workflows -a claude-codeWhat signals-scout-workflows does
The skill uses send, open, click, bounce, block, and tracking data to spot an underperforming email step. It drafts at most one change per workflow; a person must approve the suggestion before it changes anything.
It checks whether suggestions are enabled, reads metrics for the current version, and consults earlier decisions. Versions less than 48 hours old are skipped because their feedback may still be incomplete. The skill needs the PostHog Signals agent in a Claude sandbox, workflows MCP tools, analytics access, and write permissions for the scratchpad and hog_flow_proposal.
What it helps with
- spot an email step with weak open rates
- separate low engagement from disabled tracking
- draft one metrics-based workflow change
- avoid resubmitting an idea a person rejected
Example prompts for the agent
- Review opted-in PostHog workflows and suggest one change based on email metrics.
- Check whether disabled tracking explains the low open count for this email step.
- Look at rejected suggestions and avoid proposing the same change again.
How to install signals-scout-workflows
1Skills CLI (Vercel)
npx skills add PostHog/ai-plugin --skill signals-scout-workflows -a claude-code2Manually: put the files in place
~/.claude/skills/signals-scout-workflows/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/signals-scout-workflows/
1Skills CLI (Vercel)
npx skills add PostHog/ai-plugin --skill signals-scout-workflows -a codex2Manually: put the files in place
.agents/skills/signals-scout-workflows/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add PostHog/ai-plugin --skill signals-scout-workflows -a cursor2Manually: put the files in place
.cursor/skills/signals-scout-workflows/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install PostHog/ai-plugin skills/signals-scout-workflows2Manually: put the files in place
.github/skills/signals-scout-workflows/SKILL.md1Skills CLI (Vercel)
npx skills add PostHog/ai-plugin --skill signals-scout-workflows -a gemini-cli2Platform CLI
gemini skills install https://github.com/PostHog/ai-plugin --path skills/signals-scout-workflowsManually: put the files in place
.devin/skills/signals-scout-workflows/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add PostHog/ai-plugin --skill signals-scout-workflows -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-workflows
How do I install signals-scout-workflows in Claude Code?
Run npx skills add PostHog/ai-plugin --skill signals-scout-workflows -a claude-code. The skill file is at ~/.claude/skills/signals-scout-workflows/SKILL.md.
What does signals-scout-workflows do?
It examines email-step metrics in PostHog workflows and drafts up to one suggested change per workflow. A person approves the suggestion before it is applied.
What does signals-scout-workflows need to run?
It needs the PostHog Signals agent in a Claude sandbox, workflows MCP tools, and analytics access. It also needs write permissions for the scratchpad and hog_flow_proposal.