pipeline-design

Standardize Python ETL and ELT pipeline architecture with SQLAlchemy patterns.

9|Updated Feb 26, 2026
One-click install
npx skills add https://github.com/diegoscarabelli/system2 --skill pipeline-design-diegoscarabelli
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: pipeline-design
Source: https://github.com/diegoscarabelli/system2/tree/main/src/server/agents/skills/pipeline-design
Command: npx skills add https://github.com/diegoscarabelli/system2 --skill pipeline-design-diegoscarabelli

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill addresses the lack of consistency and reliability in data engineering by providing a standardized, framework-agnostic architecture for building Python-based ETL/ELT pipelines.

Core Features & Use Cases

  • Standardized State Machine: Implements a robust file-handling lifecycle (ingest, process, store, quarantine) that ensures data is never lost and remains fully auditable.
  • Config-First Design: Uses a single dataclass to define pipeline behavior, reducing boilerplate and centralizing configuration.
  • SQLAlchemy Integration: Provides helpers for schema-aware ORM modeling and idempotent bulk upserts, ensuring database integrity.
  • Use Case: Ideal for teams needing to build repeatable, production-grade data pipelines that can be easily monitored, retried, and scaled across different orchestrators like Airflow or Prefect.

Quick Start

Use the pipeline-design skill to generate a new pipeline scaffold that follows the standard directory layout and implements the required processor and configuration classes.

Frequently Asked Questions about pipeline-design

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

FAQPage Schema
How do I build a standardized Python ETL pipeline architecture that works across different orchestrators?▼

To build a standardized Python ETL pipeline, use a framework-agnostic architecture implementing specific directory layouts, file state machines, and config-first dataclasses. This ensures modular, auditable, and idempotent workflows across orchestrators like Airflow or Prefect.

What is a standardized file state machine for ETL pipelines and how does it prevent data loss?▼

A standardized file state machine for ETL pipelines enforces a file-handling lifecycle across ingest, process, store, and quarantine stages. This mechanism ensures data is never lost and remains fully auditable throughout workflow execution.

How do I perform idempotent bulk upserts in SQLAlchemy for an ETL pipeline?▼

Perform idempotent bulk upserts in SQLAlchemy for an ETL pipeline by using schema-aware ORM modeling helpers and specific database interaction patterns. This ensures database integrity and allows safe retries without duplicating data.

Can I use this pipeline design approach with both Airflow and Prefect?▼

Yes, you can use this pipeline design approach with both Airflow and Prefect. It provides a framework-agnostic architecture to build repeatable, production-grade data pipelines that can be easily monitored, retried, and scaled across various orchestrators.

What is the best way to reduce boilerplate configuration in Python data engineering pipelines?▼

The best way to reduce boilerplate configuration in Python data engineering pipelines is using a config-first design. By defining pipeline behavior through a single dataclass, you centralize configuration and eliminate repetitive setup code.