diagnosing-failed-warehouse-syncs

Diagnose failing data warehouse syncs and map root causes to recovery actions.

58|5|Updated Jan 19, 2026
One-click install
npx skills add https://github.com/PostHog/skills --skill diagnosing-failed-warehouse-syncs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: diagnosing-failed-warehouse-syncs
Source: https://github.com/PostHog/skills/tree/main/skills/omnibus/diagnosing-failed-warehouse-syncs
Command: npx skills add https://github.com/PostHog/skills --skill diagnosing-failed-warehouse-syncs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnose why a data warehouse sync is failing and recommend the right recovery action. Use when the user asks "why isn't my Stripe/Postgres/Hubspot sync working?", "this table has been stuck for hours", "the data in the warehouse looks wrong", or wants to troubleshoot a specific source or schema. Covers source-level vs schema-level failures, stuck Running states, credential and schema-drift errors, incremental-field misconfig, CDC prerequisite failures, and the cancel / reload / resync / delete-data recovery actions.

Core Features & Use Cases

  • Diagnose failing sources and schemas and guide corrective actions without data loss.
  • Interpret source-level vs schema-level failures, credential errors, and schema drift to determine the right recovery path.
  • Provide structured workflows and recovery actions (reload, resync, delete-data) with safety guidance.

Quick Start

Describe the failing source or schema, fetch its status, and present recommended actions.

Frequently Asked Questions about diagnosing-failed-warehouse-syncs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I troubleshoot a data warehouse sync that is stuck in a running state?

Troubleshoot a stuck warehouse sync by diagnosing whether the failure is at the source level or schema level, then map the root cause to a safe recovery action like cancel, reload, or resync. Check CDC prerequisites and incremental-field configurations.

Why does my ETL warehouse sync fail after a schema drift?

Schema drift causes warehouse sync failures when the source schema changes unexpectedly. Diagnose the failing schema, verify external-data-schemas, and execute a reload or resync recovery action to align the schema and restore data flow.

What is the best way to recover failed warehouse syncs without losing data?

Recover failed warehouse syncs safely by identifying root causes like credential errors or CDC prerequisite failures, then applying structured recovery actions. Use delete-data or resync workflows with safety guidance to prevent data loss during ETL recovery.

How do I diagnose CDC prerequisite failures in a warehouse sync?

Diagnose CDC prerequisite failures by checking source-level configurations and schema-level sync statuses. Identify missing incremental fields or credential errors, then map the root cause to the appropriate recovery workflow using external-data-schemas tools.

When should I use the delete-data recovery action for a failing schema sync?

Use the delete-data recovery action when a warehouse schema sync is failing due to corrupted data or severe schema drift. Diagnose the failing source or schema first, then apply this action to safely reset the sync state before reloading.

How do I fix warehouse sync credential errors for external data sources?

Fix warehouse sync credential errors by diagnosing the failing source to confirm authentication failures. Once identified as a source-level issue, update credentials and trigger a resync or reload to restore the warehouse ETL pipeline.