migrating-airflow-2-to-3

Migrate Airflow 2.x DAGs and code to Airflow 3.x with rule-based fixes.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps migrate Apache Airflow 2.x projects to Airflow 3.x, addressing code changes, imports, and compatibility issues to reduce upgrade risk.

Core Features & Use Cases

  • Upgrade planning: Provides an actionable migration path from Airflow 2.x to 3.x, including recommended upgrade steps and a migration checklist.
  • Code modernization: Highlights import changes, operator/provider mappings, and context key updates to update DAG code and tasks.
  • Use Case: When upgrades are needed, prompts you to review your DAGs, operators, and configuration and suggests concrete changes.

Quick Start

Start with a quick assessment of your Airflow 2.x DAGs to prepare an upgrade plan.

Frequently Asked Questions about migrating-airflow-2-to-3

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

FAQPage Schema
How do I upgrade Airflow 2 DAGs to Airflow 3?

To upgrade Airflow 2 DAGs to Airflow 3, use a guided migration checklist that addresses import changes, operator mappings, and context key updates to ensure full compatibility. It supports rule-based fixes across your deployment.

What are the common Airflow 2 to 3 migration code changes?

Common Airflow 2 to 3 migration code changes include updating DAG definitions, modifying imports, mapping providers, and adjusting context keys. The migration applies rule-based fixes to resolve compatibility issues.

How do I plan an Airflow 3 upgrade for existing deployments?

Planning an Airflow 3 upgrade involves reviewing existing DAGs, operators, and configuration. You generate an actionable migration path and checklist to reduce upgrade risk and ensure code modernization.

Does the Airflow 3 migration support operators and hooks?

Yes, the Airflow 3 migration supports operators and hooks. It highlights provider mappings and suggests concrete code changes to update tasks, ensuring compatibility across your Airflow deployments.

What are the Airflow 3 migration rules for compatibility?

Airflow 3 migration rules for compatibility include automated rule-based fixes ranging from AIR30 to AIR312. These rules target specific code modernization requirements to safely update DAG definitions and configurations.