# authoring-scouts

authoring-scouts is a Claude Code skill for creating, tuning, and testing PostHog Signals scouts that inspect project metrics on a schedule and submit findings.

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

## What it does

This skill instructs your coding assistant on constructing and updating PostHog Signals scouts. A scout runs on a set schedule, inspects metrics within a designated PostHog workspace, and pushes insights directly to the Signals inbox or connected Slack destinations. You can write fresh scouts for bespoke telemetry or adjust existing canonical scouts when standard alerts turn noisy.

Work begins with discovery calls. Agents run `posthog:scout-project-profile-get` alongside `posthog:read-data-schema` to confirm that required event names actually arrive from real users. Drafting instructions for nonexistent telemetry fails instantly, so schema checks happen before generating files.

The harness recently migrated its tool names from `signals-scout-*` to `scout-*`. If an environment returns errors for the updated prefixes, the skill directs the agent to query the tool registry and fall back to the older naming scheme.

## Install

### Claude Code (native platform)

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

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

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

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

## When to use it
- author custom Signals scouts for untracked business funnels
- tighten thresholds and disqualifiers on noisy canonical scouts
- route structured evaluation reports straight into Slack
- verify workspace event schemas before setting up scout configurations

## Example prompts
- Author a Signals scout that monitors payment failure events
- Tune my scout schedule and alert thresholds for web analytics
- Set up structured report output to Slack for this scout

## Similar
- [signals-scout-feature-flags](https://affpapa.org/en/nevibecode/skills/signals-scout-feature-flags.md) — skill · 318 installs
- [signals-scout-general](https://affpapa.org/en/nevibecode/skills/signals-scout-general.md) — skill · 343 installs
- [posthog-cost-tuning](https://affpapa.org/en/nevibecode/skills/posthog-cost-tuning.md) — skill · 1 install
- [metrics-dashboard](https://affpapa.org/en/nevibecode/skills/metrics-dashboard.md) — skill · 3200 installs
- [posthog-analytics](https://affpapa.org/en/nevibecode/skills/posthog-analytics.md) — skill · 827 installs
- [posthog-errors](https://affpapa.org/en/nevibecode/skills/posthog-errors.md) — skill · ★ 797 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
