airflow-hitl

Add human approval gates, form inputs, and branching to Apache Airflow DAGs.

2|Updated Apr 8, 2026
One-click install
npx skills add https://github.com/miptah21/skills --skill airflow-hitl-miptah21
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: airflow-hitl
Source: https://github.com/miptah21/skills/tree/main/.agents/skills/airflow-hitl
Command: npx skills add https://github.com/miptah21/skills --skill airflow-hitl-miptah21

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you add reliable human-in-the-loop approval gates and form-based inputs to Airflow workflows without fragile polling or custom sensors.

Core Features & Use Cases

  • Human approval gates: Use an approval step that supports approve/reject behavior to control downstream execution.
  • Form input collection: Capture structured responses from humans through interactive HITL tasks.
  • Human-driven branching: Route execution to the right downstream tasks based on human selections.
  • Deferrable HITL operators (Airflow 3.1+): Keeps worker slots available while waiting for required human action.

Quick Start

Implement an approval form in your DAG by asking for the decision using an HITL operator and wiring the result to the next tasks.

Frequently Asked Questions about airflow-hitl

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

FAQPage Schema
How do I add human approval steps to Airflow DAGs?

You can add human approval steps to Airflow DAGs using deferrable HITL operators like ApprovalOperator and HITLOperator to pause execution until a human approves or rejects the workflow.

Can I collect structured form inputs from users in an Airflow workflow?

Yes, you can collect structured form inputs from users in an Airflow workflow by creating interactive human-in-the-loop tasks that capture human responses through form-based UI actions.

How do I route Airflow workflow branching based on human selection?

You can route Airflow workflow branching based on human selection by using the HITLBranchOperator, which directs execution to specific downstream tasks depending on the choices made by the human reviewer.

Does Airflow support deferrable operators for human-in-the-loop tasks?

Yes, Airflow 3.1+ supports deferrable human-in-the-loop operators, which keep worker slots available while waiting for required human actions instead of blocking resources during the pause.

What is the best way to pause an Airflow DAG for manual review without custom sensors?

The best way to pause an Airflow DAG for manual review without fragile polling or custom sensors is using built-in HITL operators designed specifically for reliable human-in-the-loop approval gates.

Do I need Airflow 3.1 to use human-in-the-loop operators?

Yes, you need Airflow 3.1 or higher to use the deferrable human-in-the-loop operators, as they rely on the newer framework features to handle approval gates and form inputs efficiently.