librefang-registry/skills/data-pipeline/SKILL.md

name, description

name	description
data-pipeline	Data pipeline expert for ETL, Apache Spark, Airflow, dbt, and data quality

Data Pipeline Expert

A data engineering specialist with extensive experience designing and operating production ETL/ELT pipelines, orchestration frameworks, and data quality systems. This skill provides guidance for building reliable, observable, and scalable data pipelines using industry-standard tools like Apache Airflow, Spark, and dbt across batch and streaming architectures.

Key Principles

• Prefer ELT over ETL when your target warehouse can handle transformations; load raw data first, then transform in place for reproducibility and auditability
• Design every pipeline step to be idempotent; re-running a task with the same inputs must produce the same outputs without side effects or duplicates
• Partition data by time or logical keys at every stage; partitioning enables incremental processing, efficient pruning, and manageable backfill operations
• Instrument pipelines with data quality checks between stages; catching bad data early prevents cascading corruption through downstream tables
• Separate orchestration (when and what order) from computation (how); the scheduler should not perform heavy data processing itself

Techniques

• Build Airflow DAGs with task-level retries, timeouts, and SLAs; use sensors for external dependencies and XCom for lightweight inter-task communication
• Design Spark jobs with proper partitioning (repartition/coalesce), broadcast joins for small dimension tables, and caching for reused DataFrames
• Structure dbt projects with staging models (source cleaning), intermediate models (business logic), and mart models (final consumption tables)
• Write dbt tests at multiple levels: schema tests (not_null, unique, accepted_values), relationship tests, and custom data tests for business rules
• Implement data quality gates using frameworks like Great Expectations: define expectations on row counts, column distributions, and referential integrity
• Use Change Data Capture (CDC) patterns with tools like Debezium to stream database changes into event pipelines without polling

Common Patterns

• Incremental Load: Process only new or changed records using high-watermark columns (updated_at) or CDC events, falling back to full reload on schema changes
• Backfill Strategy: Design DAGs with date-parameterized runs so historical reprocessing uses the same code path as daily runs, just with different date ranges
• Dead Letter Queue: Route failed records to a separate table or topic for investigation and reprocessing instead of halting the entire pipeline
• Schema Evolution: Use schema registries (Avro, Protobuf) or column-add-only policies to evolve data contracts without breaking downstream consumers

Pitfalls to Avoid

• Do not perform heavy computation inside Airflow operators; delegate to Spark, dbt, or external compute and use Airflow only for orchestration
• Do not skip data validation after ingestion; silent schema changes from upstream sources are the most common cause of pipeline failures
• Do not hardcode connection strings or credentials in pipeline code; use secrets managers and environment-based configuration
• Do not run full table scans on every pipeline execution when incremental processing is feasible; it wastes compute and increases latency