Official agent skill

Working With Scouts

by PostHog in PostHog/posthog

Work with PostHog Signals scouts: scheduled agents that monitor a project and write reports into the Signals inbox.

OfficialCustom licenceAuto-check passedDevOps & Cloud

Install Working With Scouts

skills CLI
$ npx skills add PostHog/posthog --skill working-with-scouts -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install PostHog/posthog working-with-scouts --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/PostHog/posthog.git skills-src && mkdir -p .claude/skills && cp -r skills-src/products/signals/skills/working-with-scouts .claude/skills/working-with-scouts && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
working-with-scouts
GitHub stars
40k
Token cost
~8.7k tokens
SKILL.md length
4,468 words
Files
2 (incl. references)
Skills in repo
252
Repo updated
First seen
Licence
Custom licence

At a glance

Work with PostHog Signals scouts: scheduled agents that monitor a project and write reports into the Signals inbox.

  • Works in 5 steps: Delegate — decide what the fleet should… → Receive — reports land in the inbox,… → Act — verify the finding, fix it (or… → …
  • Assign monitoring work
  • SKILL.md covers First: is the fleet running?, The working loop, Delegating a job and Acting on what comes back, plus 5 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Working With Scouts is an agent skill from PostHog/posthog, published by the product's own GitHub organization. Work with PostHog Signals scouts: scheduled agents that monitor a project and write reports into the Signals inbox. Use to assign monitoring work, schedule quality scoring, find which scout covers a surface, act on reports, reduce noise, investigate missing findings, or improve the fleet through feedback and calibration. Also covers follow-up checks that verify whether a reported problem stays fixed. Use authoring-scouts for edits, exploring-scouts for run observability, and inbox-exploration for report triage…

Its SKILL.md is about 8.7k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/delegation-recipes.md`).

It sits in DevOps & Cloud, covering Email management, Performance reviews and Observability. It works with PostHog. The repository describes itself as: :hedgehog: PostHog is the leading platform for building self-driving products. Our developer tools – AI observability, analytics, session replay, flags, experiments, error…

When your agent uses it

  • Assign monitoring work
  • Schedule quality scoring
  • Find which scout covers a surface
  • Investigate missing findings

Example prompts

  • “work with my scouts”
  • “get more out of scouts”
  • “have a scout watch X”
  • “/working-with-scouts”

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Delegate — decide what the fleet should watch, and get the right scout watching it.
  2. Receive — reports land in the inbox, routed to a suggested reviewer when the scout could name one.
  3. Act — verify the finding, fix it (or decide not to), and record the outcome on the report.
  4. Feed back — the outcome and your written reasons flow back to the scout, along with any notes you leave.
  5. Calibrate — periodically review fleet health and promote recurring steers into permanent policy.

What it can do on your machine

Read from SKILL.md and the folder at commit 812e5c6. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • posthog.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Working With Scouts loads about 8.7k tokens when it runs, and up to ~12k if it reads all its reference files. Until then it costs about 193 tokens; SKILL.md has 4,468 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~193
When it runs · the whole SKILL.md, loaded when a task matches
~8.7k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~12k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 4,468 words (~8,744 tokens).

“A scout is a scheduled agent that wakes on its own interval, looks at one PostHog project, and either writes a finding into the Signals inbox as a report or closes out empty. Think of the fleet as a team…”

— opening of SKILL.md by PostHog, Custom licence
name
working-with-scouts
metadata.owner_team
signals

Read the full SKILL.md on GitHub

Files

SKILL.md and 1 other file (references) in products/signals/skills/working-with-scouts of PostHog/posthog.

  • SKILL.md
  • references/delegation-recipes.md

Open the folder on GitHubat commit 812e5c6

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders. This page covers the copy in PostHog/posthog, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Working With Scouts next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Working With Scouts compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Working With Scouts this skillPostHog/posthog40k—~8.7kAutomated safety check: PassCustom licence
Telemetry AnalyticsOpenHands/OpenHands90k—~305Automated safety check: PassMIT
Temps Best Practicesgotempsh/temps828—~2.9kAutomated safety check: PassApache-2.0
Posthog Observabilityjeremylongshore/tons-of-skills-marketplace2.8k—~2.4kAutomated safety check: PassMIT
Posthog Operationsshepherdjerred/monorepo112—~321Automated safety check: PassGPL-3.0
Sentry Miniapp SDKlizhiyao/sentry-miniapp687—~5.1kAutomated safety check: PassMIT

Similar skills

  • Telemetry Analytics

    OpenHands/OpenHands

    This skill should be used when the user asks to "add tracking", "add a PostHog event", "change telemetry consent", "instrument onboarding", "debug analytics", or changes telemetry.ts…

    90k GitHub stars~305 tokensUpdated today
    DevOps & CloudAuto-check passed
  • Temps Best Practices

    gotempsh/temps

    Best-practices reference for preparing and instrumenting applications on Temps.

    828 GitHub stars~2.9k tokensUpdated today
    DevOps & CloudAuto-check passed
  • Posthog Observability

    jeremylongshore/tons-of-skills-marketplace

    Observe a PostHog integration through application-side delivery metrics, ingestion warnings, billing volume, destination logs, and status evidence.

    2.8k GitHub stars~2.4k tokensUpdated today
    DevOps & CloudAuto-check passed
  • Posthog Operations

    shepherdjerred/monorepo

    Query or manage this repository's PostHog analytics, schema, dashboards, insights, feature flags, experiments, replay, and observability through toolkit posthog.

    112 GitHub stars~321 tokensUpdated today
    DevOps & CloudAuto-check passed
  • Sentry Miniapp SDK

    lizhiyao/sentry-miniapp

    Full Sentry SDK setup for Mini Programs — error monitoring, tracing, offline cache, source maps.

    687 GitHub stars~5.1k tokensUpdated today
    DevOps & CloudAuto-check passed
  • PostHog AI Observability integration for LangChain (Python). An agent skill from Jwuthri/Tracely-ai.

    1.5k GitHub stars~2.2k tokensUpdated 2 days ago
    AI & LLM EngineeringAuto-check passed

More from PostHog/posthog

All 252 skills in this repo
  • Authoring Log Alerts

    PostHog/posthog

    Official

    Author useful, low-noise log alerts on services in a PostHog project.

    40k GitHub stars~3k tokensUpdated today
    Auto-check passed
  • Official

    Operating procedure for the conflict-autoresolver agent: sweep open PostHog/posthog PRs that conflict with master, resolve the trivial conflicts (generated artifacts deterministically, source…

    40k GitHub stars~4.2k tokensUpdated today
    Auto-check passed
  • Official

    Help users debug PostHog Error Tracking stack-trace symbolication for any supported platform — JavaScript/TypeScript web, React Native (Hermes), Android (Proguard / R8), or iOS / macOS (dSYM).

    40k GitHub stars~2.2k tokensUpdated today
    Auto-check passed
  • Exploring Apm Traces

    PostHog/posthog

    Official

    Investigates distributed application performance using PostHog APM (OpenTelemetry span) data via MCP.

    40k GitHub stars~3.5k tokensUpdated today
    Auto-check passed
  • Exploring LLM Traces

    PostHog/posthog

    Official

    Debug and inspect LLM/AI agent traces using PostHog's MCP tools.

    40k GitHub stars~4.4k tokensUpdated today
    Auto-check passed
  • Investigate Metric

    PostHog/posthog

    Official

    Diagnose why a product metric changed (dropped, spiked, or plateaued) by orchestrating breakdowns, actors, paths, lifecycle, retention, and annotations queries.

    40k GitHub stars~1.9k tokensUpdated today
    Auto-check passed

Works with

Questions about Working With Scouts

What does Working With Scouts do?

Work with PostHog Signals scouts: scheduled agents that monitor a project and write reports into the Signals inbox. Working With Scouts is an agent skill from PostHog/posthog, published by the product's own GitHub organization. Work with PostHog Signals scouts: scheduled agents that monitor a project and write reports into the Signals inbox.

When should I use Working With Scouts?

Working With Scouts fits situations like: assign monitoring work; schedule quality scoring; find which scout covers a surface; investigate missing findings.

How do I install Working With Scouts in Claude Code?

Run `npx skills add PostHog/posthog --skill working-with-scouts -a claude-code`. Or copy the skill folder (products/signals/skills/working-with-scouts in PostHog/posthog) into .claude/skills/working-with-scouts in your project. Claude Code loads it when a task matches its description.

How do I install Working With Scouts in Codex?

Run `npx skills add PostHog/posthog --skill working-with-scouts -a codex`. Or copy the skill folder (products/signals/skills/working-with-scouts in PostHog/posthog) into .agents/skills/working-with-scouts in your project. Codex loads it when a task matches its description.

Can I use Working With Scouts in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add PostHog/posthog --skill working-with-scouts -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/working-with-scouts, .gemini/skills/working-with-scouts, .github/skills/working-with-scouts and .opencode/skills/working-with-scouts in your project.

What does Working With Scouts need to run?

SKILL.md names no scripts, command-line tools or credentials: Working With Scouts is instructions for the agent only.

Does Working With Scouts access the network?

SKILL.md names 1 domain. As links in the text: posthog.com. This is read from the text; nothing was executed.

Is Working With Scouts safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Working With Scouts use?

Working With Scouts has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Working With Scouts use?

About 8.7k tokens (SKILL.md is roughly 35k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 3.1k tokens, read only when the agent opens those files.

What are the alternatives to Working With Scouts?

Skills that share tags, products or a category with Working With Scouts: Telemetry Analytics (OpenHands/OpenHands, 90k stars), Temps Best Practices (gotempsh/temps, 828 stars), Posthog Observability (jeremylongshore/tons-of-skills-marketplace, 2.8k stars) and Posthog Operations (shepherdjerred/monorepo, 112 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Working With Scouts?

PostHog (a GitHub organization, an official publisher) maintains it in PostHog/posthog, which has 40,200 GitHub stars. The repository holds 252 skills in this directory. The repository was last updated on October 9, 2026.

Source: PostHog/posthog on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.