Skip to content
Get packs

Managed Airflow Migration Guide

Guides an agent through migrating Airflow DAG code to Airflow 2.11.1 or Airflow 3 on Google Cloud

Source Download skill
Repository
google/skills
Stars
21,782
Licence
Apache-2.0
Files
5 files

What it does

Airflow is a tool for scheduling data pipelines written as Python files called DAGs. When you upgrade Airflow, some code stops working. With this skill installed, the agent follows a structured checklist for Google Cloud's managed Airflow service (formerly Cloud Composer): it looks up which provider library versions and breaking changes apply, scans your DAG code with search commands for patterns that will break, and suggests fixes. It can also download DAG files from a managed environment when you ask it to.

Great for

  • Data engineers moving existing Cloud Composer or Managed Airflow DAGs to Airflow 2.11.1
  • Teams planning an upgrade to Airflow 3 on Managed Service for Apache Airflow Gen 3
  • Developers who want a checklist of breaking changes to scan their DAG code against

Skip it if

  • Debugging failed DAG runs unrelated to code migration, which the skill says not to use for (the scans only find known code patterns)
  • Non-Google Cloud Airflow deployments, since the guidance is specific to Managed Service for Apache Airflow
  • Production environments without a backup or review, because the agent may edit DAG code and download or upload files to cloud storage

Try asking

  • “Scan my ./dags folder and tell me what breaks if I upgrade to Airflow 3”
  • “Migrate my DAGs from Composer 2.10 to Airflow 2.11.1 and list the provider changes I need”
  • “Download the DAG files from my Managed Airflow environment and check them for Pendulum 3 issues”
Step-by-step guide: how to use Managed Airflow Migration GuideInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 5 original files, the Apache-2.0 licence and an attribution note.

    managed-airflow-migrations.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip managed-airflow-migrations.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip managed-airflow-migrations.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Ask for the specific target version (2.11.1 or Airflow 3) so the agent only applies the relevant scans.
  • Work on a copy of your DAG folder in a local workspace and review every suggested change before deploying.
  • Check the referenced attribution and environment-inspection docs if you want to know exactly which gcloud commands run and what they send.

What's inside

  • references/airflow-3.md
  • references/attribution.md
  • references/environment-inspection.md
  • references/local-development-environment.md
  • SKILL.md

Redistributed unmodified from google/skills under the Apache-2.0 licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.