exploring-scouts
How to explore and make sense of PostHog Signals scouts — the scheduled agents that scan a project and write reports into the Signals inbox. Use when a user wants to understand what scouts they have, how each one is behaving, and whether the fleet is actually working. Covers surveying the fleet and its schedules, reading recent scout runs and drilling into a single run's reasoning, inspecting the durable scratchpad memory the fleet has built up, tracing a run to the reports it wrote or edited, reading the follow-up checks still measuring a report, and assessing a scout's health and performance over time (cadence, success rate, report rate, signal-to-noise). Read-only and exploratory — to write or tune a scout, use authoring-scouts instead. Trigger on "what are my scouts doing", "how is my <x> scout performing", "show me recent scout runs", "why did this scout find/report nothing", "what has the fleet learned", "explore scout run <id>", "is my scout working".
Pinned to revision 4e8964e24a5a, so it is the text this page describes rather than whatever the author pushed since.
Files
- skills/exploring-scouts/SKILL.md
- skills/exploring-scouts/references/assessing-performance.md
- skills/exploring-scouts/references/scout-data-model.md
- skills/exploring-scouts/scripts/assess_health.py
- skills/exploring-scouts/scripts/fleet_survey.py
- skills/exploring-scouts/scripts/render_run_report.py
Every link opens the file at its source, pinned to the revision this page describes.