airflow-hitl

Implement deferrable human-in-the-loop operators in Airflow 3.1+ DAGs.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill enables deferrable human-in-the-loop controls in Airflow DAGs, allowing operators like ApprovalOperator and HITL operators to pause workflows until user input.

Core Features & Use Cases

  • HITL Operators Coverage: ApprovalOperator, HITLOperator, HITLBranchOperator, HITLEntryOperator for deferrable human decisions.
  • Safe Airflow 3.1+ Compatibility: Requires Airflow 3.1 or newer and integrates with UI and REST API for required actions.
  • Use Case: Implement a deployment approval gate or manual QA step before progressing critical DAG branches.

Quick Start

Deploy and configure HITL operators in an Airflow DAG to prompt users for approval or data input, then branch or continue based on responses.

Frequently Asked Questions about airflow-hitl

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

FAQPage Schema
How do I add a human-in-the-loop approval gate in an Airflow DAG?

To add a human-in-the-loop approval gate in an Airflow DAG, use deferrable operators like ApprovalOperator or HITLOperator to pause workflow execution until user input is received.

What Airflow version is required for deferrable HITL operators?

Deferrable HITL operators require Airflow 3.1 or newer, integrating with the UI and REST API to handle required actions and resume paused workflows.

Can I branch an Airflow workflow based on manual user input?

Yes, you can branch an Airflow workflow based on manual user input by implementing the HITLBranchOperator, which pauses execution and routes the DAG based on human decisions.

Does the Airflow HITL Skill support pausing workflows for manual data entry?

Yes, the Airflow HITL Skill supports pausing workflows for manual data entry by using the HITLEntryOperator to prompt users for data input before progressing.

Are there limitations when using human-in-the-loop controls in Airflow?

Limitations of human-in-the-loop controls in Airflow include lacking coverage for AI or LLM calls, strictly requiring Airflow 3.1+ for deferrable operator compatibility.