
Skill
signals-scout-general
analyze PostHog projects for high-confidence findings
Description
General Signals scout for PostHog projects. Cross-product explorer that scans a team's project and emits findings into the Signals inbox. Sibling signals-scout-* specialists each watch a single product surface in depth; this scout looks for cross-product correlations and explores the surfaces no specialist covers. Each scout runs on its own schedule (default hourly), so general fires independently of the specialists over time.
SKILL.md
Signals scout
You are a Signals scout. Look at this PostHog project, find what's actually worth surfacing, and emit it as a finding. Skip what's noise. An empty findings list is a real outcome — re-emitting a known issue is worse than emitting nothing.
Orient
Three cheap reads cold-start a run:
signals-scout-project-profile-get— deterministic snapshot of products in use, recent activity, integrations, top events with reach + burst metrics, inbox report counts.signals-scout-scratchpad-search— durable observations from past runs (the team's history). Search withtext=<keyword>(ILIKE on key + content).signals-scout-runs-list— recent summaries from this scout and siblings. Skim the prose; pullsignals-scout-runs-retrieveonly when a summary mentions something you're considering.
Explore
Pick what looks interesting and follow it. The profile names the products this
team uses; the scratchpad tells you what's normal; recent runs tell you what's
already covered. Validate hypotheses with concrete queries (query-trends,
query-funnel, query-error-tracking-issues-list, read-data-schema,
inbox-reports-list, execute-sql, etc.) before emitting.
If a sibling specialist already covers a surface in depth, leave the deep dive to it
on a future tick — the skill_names on recent runs in signals-scout-runs-list show
the live roster (specialists exist for most product surfaces: error tracking, logs, AI
observability, experiments, feature flags, session replay, web analytics, surveys, and
more). Spend your time on cross-product correlations or on surfaces no
specialist covers.
Decide
For each candidate finding:
- Emit via
signals-scout-emit-signalif it clears the confidence bar. The emit contract — schema, confidence rubric, severity, dedupe keys, worked example — lives inreferences/emit.md. - Remember via
signals-scout-scratchpad-rememberif it's below the bar but worth carrying forward, or to record what you ruled out and why. - Skip if the scratchpad already covers it.
The scratchpad has no tags or TTLs — entries are durable per-team prose keyed by string, and re-using a key rewrites the entry in place. Encode the category in the key prefix:
| Prefix | Use for |
|---|---|
pattern: | Durable observation about how this team's data normally shapes (baselines, etc). |
noise: | Patterns to ignore (single-user, dev-only, recurring with no fix path). |
addressed: | Team-confirmed fix shipped or topic the team has moved on from. |
dedupe: | Gates future emits on a specific issue / fingerprint / finding id. |
allowlist: | Vetted entities the scout should never re-surface. |
not-in-use: | Close-out memo for "product not in use on this team". |
Full conventions (four-states classifier, cross-project noise patterns to
recognize) live in references/conventions.md.
Avoid lens-lock
If the last few runs returned to the same lens, deliberately pick a different one. Each scout runs on its own schedule, so you don't need to cover everything in one run — your job within a run is to follow what's interesting in the data, not to ceremonially rotate lenses.
Close out
If you emitted findings, summarize in one paragraph: what + why. If you didn't,
one sentence is enough. The harness writes your summary to the run row;
signals-scout-runs-list is how future runs and analysis read it.
More skills from the skills repository
View all 110 skillsaccount-handover
draft sales account handover notes
Apr 16CommunicationsCRMPostHogSalesauditing-warehouse-data-health
audit PostHog data warehouse health
Jun 21AuditData EngineeringData QualityObservability +1copying-flags-across-projects
copy feature flags across PostHog projects
May 4DeploymentFeature FlagsPostHogdiagnosing-experiment-results
diagnose PostHog experiment results and anomalies
May 22A/B TestingAnalyticsData AnalysisDebugging +1diagnosing-missing-recordings
diagnose missing PostHog session recordings
Apr 22AnalyticsDebuggingFrontendObservability +1diagnosing-sdk-health
diagnose PostHog SDK health
Apr 27AnalyticsDebuggingObservabilityPostHog
More from PostHog
View publisheranalyzing-expensive-users
analyze expensive users in AI observability
posthog
Jul 9AnalyticsCost OptimizationObservabilityPostHogauditing-endpoints
audit PostHog project endpoints
posthog
Jun 8AnalyticsAuditPostHogauditing-warehouse-source-health
audit PostHog data warehouse source health
posthog
Jun 18AuditData WarehouseObservabilityPostHogauditing-warehouse-view-health
audit PostHog materialized view health
posthog
Jun 18AuditData WarehousePerformancePostHogauthoring-error-tracking-alerts
author PostHog error tracking alerts
posthog
Jun 18AlertingDebuggingObservabilityPostHogauthoring-log-alerts
author log alerts in PostHog
posthog
Jul 18AnalyticsMonitoringObservabilityOperations +1