# signals-scout-workflows

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.

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

## What it 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`.

## Install

### Claude Code (native platform)

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

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

### Codex

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

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

### Cursor

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

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

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

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

## When to use it
- 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
- 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.

## Similar
- [signals-scout-general](https://affpapa.org/en/nevibecode/skills/signals-scout-general.md) — skill · 343 installs
- [signals-scout-experiments](https://affpapa.org/en/nevibecode/skills/signals-scout-experiments.md) — skill · 319 installs
- [customer-churn-signals](https://affpapa.org/en/nevibecode/skills/customer-churn-signals.md) — skill · 26700 installs
- [weekly-cleanup-routine](https://affpapa.org/en/nevibecode/skills/weekly-cleanup-routine.md) — skill · ★ 81 repo stars
- [ga4-measurement-plan](https://affpapa.org/en/nevibecode/skills/ga4-measurement-plan.md) — skill · ★ 116 repo stars
- [bounce-monitoring-workflow](https://affpapa.org/en/nevibecode/skills/bounce-monitoring-workflow.md) — skill · ★ 81 repo stars

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
