Skip to main content
skill CX Codex

authoring-scouts — Claude Code skill: what it does, how to install

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.

no license 196 installs ★ 101 updated 2026-11-16

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

What authoring-scouts 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.

What it helps with

  • 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 for the agent

  • 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

How to install authoring-scouts

1Skills CLI (Vercel)

npx skills add PostHog/ai-plugin --skill authoring-scouts -a claude-code

2Manually: put the files in place

~/.claude/skills/authoring-scouts/SKILL.md

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

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about authoring-scouts

How to install authoring-scouts in Claude Code?

Run npx skills add PostHog/ai-plugin --skill authoring-scouts -a claude-code in your terminal shell.

What does authoring-scouts do?

It guides your assistant through writing SKILL.md prompts, managing scout configs, and validating PostHog telemetry before launching scheduled monitors.

What happens if scout tools fail with unknown command errors?

Scout tooling recently switched names from signals-scout-* to scout-*; inspect your catalog and call the legacy prefix if the newer one is not exposed yet.

Similar skills

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

From the same set82

The whole set →
exploring-ai-failures exploring-ai-failures reads real production traces from PostHog and returns a ranked list of the ways your LLM feature breaks. CX Codex +1 198installs resolving-ingestion-warnings resolving-ingestion-warnings walks through PostHog ingestion warnings: dropped events, rejected person merges, oversized payloads. Use it when event counts look low or identify calls misbehave. CX Codex +1 197installs exploring-scouts exploring-scouts reads the state of PostHog Signals scouts: which ones a project has, how recent runs went, and where their reports ended up. Read-only. CX Codex +1 197installs debugging-surveys debugging-surveys investigates why PostHog Surveys fail to appear or record complete answers. Useful for support cases involving targeting, SDK behavior, and stored responses. CX Codex +1 197installs creating-online-evaluations creating-online-evaluations — a Claude Code skill that turns production failure modes into continuously-running online evaluations in PostHog. It starts when new generations need automatic scoring against specific errors. CX Codex +1 195installs signals-scout-insight-alerts signals-scout-insight-alerts — a Claude Code skill for reviewing insight alert history in PostHog. It scans recent alert triggers and flags material incidents that missed notifying the team. CX Codex +1 195installs signals-scout-data-warehouse signals-scout-data-warehouse monitors warehouse imports for failures, stale data, and sharp row-count drops, then flags recurring query patterns that may merit materialized views. CX Codex +1 195installs signals-scout-mcp-tool-calls signals-scout-mcp-tool-calls — a PostHog Signals skill that sifts $mcp_tool_call telemetry for MCP tools agents struggle with, then files one report per product category. CX Codex +1 194installs

Project sponsors

Companies that keep this analytics open