Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add PostHog/ai-plugin --skill working-with-scouts -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/working-with-scouts/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/working-with-scouts/

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.

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set82

The whole set →
context-layer-dreaming The context-layer-dreaming Claude Code skill turns recent organizational activity into lasting context wiki updates. It runs for nightly or incremental refreshes based on completed work and other activity. CX Codex +1 148installs validating-and-publishing-canvases The validating-and-publishing-canvases skill for Claude Code checks PostHog Canvas source projects and publishes them with version guards. It verifies declared capabilities and handles merge conflicts without data loss. CX Codex +1 148installs analyzing-task-runs analyzing-task-runs — a Claude Code skill that breaks down a completed task run from its log and records the activities. It starts when asked to analyze a run or review an attached log. CX Codex +1 148installs review-hog-resolution-criteria The review-hog-resolution-criteria Claude Code skill resolves open pull request review comments. It makes verifiable changes, explains declines, and hands risky decisions to a person. CX Codex +1 148installs setting-up-warehouse-properties The setting-up-warehouse-properties Claude Code skill maps warehouse columns to person or group properties in PostHog. It runs for reverse ETL setup or when replacing a recurring identify job. CX Codex +1 148installs suggesting-path-cleaning-rules suggesting-path-cleaning-rules is a Claude Code skill that proposes URL path-cleaning rules for web analytics. It engages on requests to generate or inspect suggestions and troubleshoot path_cleaning_suggestions issues. CX Codex +1 148installs authoring-data-quality-checks authoring-data-quality-checks is a Claude Code skill that adds and runs dbt-style data quality checks on warehouse tables and HogQL metrics. It runs when validating models or checking for nulls and duplicates. CX Codex +1 148installs querying-canvas-data The querying-canvas-data Claude Code skill helps put PostHog data into a canvas and make its metrics traceable to their source. It applies when a canvas needs charts, tables, analytics events, or data from GitHub or an MCP server. CX Codex +1 148installs

Project sponsors

Companies that keep this analytics open