working-with-scouts — Claude Code skill for PostHog monitoring
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.
no license 148 installs ★ 101 updated 2026-10-24
npx skills add PostHog/ai-plugin --skill working-with-scouts -a claude-codeWhat working-with-scouts 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.
What it helps with
- 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 for the agent
- 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.
How to install working-with-scouts
1Skills CLI (Vercel)
npx skills add PostHog/ai-plugin --skill working-with-scouts -a claude-code2Manually: put the files in place
~/.claude/skills/working-with-scouts/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/working-with-scouts/
1Skills CLI (Vercel)
npx skills add PostHog/ai-plugin --skill working-with-scouts -a codex2Manually: put the files in place
.agents/skills/working-with-scouts/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add PostHog/ai-plugin --skill working-with-scouts -a cursor2Manually: put the files in place
.cursor/skills/working-with-scouts/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install PostHog/ai-plugin skills/working-with-scouts2Manually: put the files in place
.github/skills/working-with-scouts/SKILL.md1Skills CLI (Vercel)
npx skills add PostHog/ai-plugin --skill working-with-scouts -a gemini-cli2Platform CLI
gemini skills install https://github.com/PostHog/ai-plugin --path skills/working-with-scoutsManually: put the files in place
.devin/skills/working-with-scouts/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add PostHog/ai-plugin --skill working-with-scouts -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 working-with-scouts
How do I install working-with-scouts in Claude Code?
Run npx skills add PostHog/ai-plugin --skill working-with-scouts -a claude-code. The skill file is installed at ~/.claude/skills/working-with-scouts/SKILL.md.
What does working-with-scouts do?
It helps assign monitoring work to PostHog Signals scouts, handle their reports, and guide the fleet through feedback and calibration.
What does working-with-scouts need to work?
It needs a PostHog Signals project and access to its canonical parent. Credentials limited to a child environment cannot read or change scout data.