# working-with-scouts

The working-with-scouts Claude Code skill helps manage PostHog Signals scouts that watch a project and send reports to the Signals inbox. Assign monitoring tasks, review findings, and steer the scouts with feedback.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 148 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/working-with-scouts/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/working-with-scouts

## What it does

The skill explains how to delegate project monitoring to PostHog scouts, handle their findings, and guide the scout fleet over time. Its workflow runs from choosing what to watch through checking a report and recording an outcome. Scouts can also run follow-up checks to see whether a reported issue remains fixed.

PostHog tools provide scout metadata, configuration, and project-profile data. Scout descriptions help identify coverage; reports can be reviewed, dismissed, or snoozed, with written reasons and notes feeding back into later work. Access to scout data is tied to the project's canonical parent: credentials scoped only to a child environment receive a 403 error.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add PostHog/ai-plugin --skill working-with-scouts -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add PostHog/ai-plugin --skill working-with-scouts -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add PostHog/ai-plugin --skill working-with-scouts -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/working-with-scouts/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install PostHog/ai-plugin skills/working-with-scouts
```

2. **Manually: put the files in place**
- File: `.github/skills/working-with-scouts/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add PostHog/ai-plugin --skill working-with-scouts -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/PostHog/ai-plugin --path skills/working-with-scouts
```

### Windsurf (Devin Desktop)

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

### OpenCode

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

## When to use it
- assign a scout to monitor part of a project
- find which scout covers a product area
- review a report and record its outcome
- investigate missed findings and reduce noise
- schedule recurring quality scoring

## Example prompts
- Ask a scout to watch for error spikes in my project.
- Review this scout report and record why the finding is incorrect.
- Find the scout that monitors web analytics.

## Similar
- [signals-scout-health-checks](https://affpapa.org/en/nevibecode/skills/signals-scout-health-checks.md) — skill · 317 installs
- [signals-scout-feature-flags](https://affpapa.org/en/nevibecode/skills/signals-scout-feature-flags.md) — skill · 318 installs
- [posthog-cost-tuning](https://affpapa.org/en/nevibecode/skills/posthog-cost-tuning.md) — skill · 1 install
- [posthog-errors](https://affpapa.org/en/nevibecode/skills/posthog-errors.md) — skill · ★ 797 repo stars
- [working-with-dbt-mesh](https://affpapa.org/en/nevibecode/skills/working-with-dbt-mesh.md) — skill · 908 installs
- [Sequential Thinking Working Notes](https://affpapa.org/en/nevibecode/mcp/sequential-thinking-working-notes.md) — MCP server · ★ 962 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
