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.