auditing-warehouse-source-health — Claude Code skill: how to install
auditing-warehouse-source-health audits PostHog data warehouse sources and syncs to pinpoint broken connectors, failed schemas, and degraded webhooks.
no license 204 installs ★ 101 updated 2026-11-16
npx skills add PostHog/ai-plugin --skill auditing-warehouse-source-health -a claude-codeWhat auditing-warehouse-source-health does
This skill inspects your PostHog warehouse ingestion pipeline to compile an overview of active connection failures. It queries the data-warehouse-data-health-issues-retrieve tool, categorizing issues by operational impact. Broken source connections appear first because a dead connector halts every underlying schema, followed by billing quota blocks and table-level errors.
For deeper inspection, it pulls from external-data-sources-list and external-data-schemas-list, checking webhook states through external-data-sources-webhook-info-retrieve. The default health endpoint only flags active failures. Schemas paused by users or syncs marked Completed that stopped updating days ago require inspecting last_synced_at timestamps directly.
What it helps with
- identify failing imports across PostHog warehouse connections
- detect schema drift and broken database table syncs
- spot silent webhook failures that regular health checks miss
- triage stale dashboard data during project handovers
Example prompts for the agent
- Audit my PostHog warehouse sources and show what is failing
- Why are warehouse imports broken across my project?
- Check source connection health and list tables hitting billing limits
How to install auditing-warehouse-source-health
1Skills CLI (Vercel)
npx skills add PostHog/ai-plugin --skill auditing-warehouse-source-health -a claude-code2Manually: put the files in place
~/.claude/skills/auditing-warehouse-source-health/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/auditing-warehouse-source-health/
1Skills CLI (Vercel)
npx skills add PostHog/ai-plugin --skill auditing-warehouse-source-health -a codex2Manually: put the files in place
.agents/skills/auditing-warehouse-source-health/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add PostHog/ai-plugin --skill auditing-warehouse-source-health -a cursor2Manually: put the files in place
.cursor/skills/auditing-warehouse-source-health/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install PostHog/ai-plugin skills/auditing-warehouse-source-health2Manually: put the files in place
.github/skills/auditing-warehouse-source-health/SKILL.md1Skills CLI (Vercel)
npx skills add PostHog/ai-plugin --skill auditing-warehouse-source-health -a gemini-cli2Platform CLI
gemini skills install https://github.com/PostHog/ai-plugin --path skills/auditing-warehouse-source-healthManually: put the files in place
.devin/skills/auditing-warehouse-source-health/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add PostHog/ai-plugin --skill auditing-warehouse-source-health -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about auditing-warehouse-source-health
How to install auditing-warehouse-source-health in Claude Code?
Run npx skills add PostHog/ai-plugin --skill auditing-warehouse-source-health -a claude-code. The skill file is stored at ~/.claude/skills/auditing-warehouse-source-health/SKILL.md.
What does the auditing-warehouse-source-health skill do?
It queries PostHog endpoints to surface broken connectors, failing schemas, and webhook errors in an actionable summary grouped by severity.
When should I use diagnosing-failed-warehouse-syncs instead?
Use this skill for a project-wide scan to locate all broken sources, then switch to diagnosing-failed-warehouse-syncs to troubleshoot a single failing sync.