diagnosing-sdk-health
Installation
SKILL.md
Diagnosing SDK health
Outdated PostHog SDKs surface through the project's generic health issues — the same
framework that reports data-warehouse sync failures, missing web-analytics events, ingestion
warnings, and more. SDK problems are the sdk_outdated kind. The backend has already applied
smart semver rules (grace periods, minor-count thresholds, age-based detection) and
traffic-percentage thresholds, so you don't reason about versions yourself — you read the
detected issues and act on the fix-it guidance each one carries.
Available tools
| Tool | Purpose |
|---|---|
posthog:health-issues-summary |
Aggregated counts of active issues by severity and kind. Quick triage before drilling in. |
posthog:health-issues-list |
Lists issues. Filter with kind=sdk_outdated to get just the SDK ones. |
posthog:health-issues-get |
One issue, enriched with a title, summary, link, and remediation.{human, agent}. |
posthog:execute-sql |
Run the query from remediation.agent to see which versions still send events. |
posthog:docs-search |
Look up an SDK's changelog / upgrade guide, as remediation.agent directs. |