Agent-Skills.md

Agent Skills: Airflow Adapter Pattern

Airflow adapter pattern for v2/v3 API compatibility. Use when working with adapters, version detection, or adding new API methods that need to work across Airflow 2.x and 3.x.

UncategorizedID: astronomer/agents/airflow-adapter

Repository

astronomer/agents
astronomerLicense: Apache-2.0
40054

Install this agent skill to your local

pnpm dlx add-skill https://github.com/astronomer/agents/tree/HEAD/astro-airflow-mcp/.claude/skills/airflow-adapter

Skill Files

Browse the full folder contents for airflow-adapter.

Download Skill

Loading file tree…

astro-airflow-mcp/.claude/skills/airflow-adapter/SKILL.md

Skill Metadata

Name
airflow-adapter
Description
Airflow adapter pattern for v2/v3 API compatibility. Use when working with adapters, version detection, or adding new API methods that need to work across Airflow 2.x and 3.x.

Airflow Adapter Pattern

Enables compatibility with both Airflow 2.x (/api/v1) and 3.x (/api/v2).

Architecture

MCP Tool → _get_adapter() → AirflowV2Adapter or AirflowV3Adapter → Airflow API

Version is auto-detected at startup.

Key Files

  • adapters/base.py - Abstract interface
  • adapters/airflow_v2.py - Airflow 2.x (/api/v1)
  • adapters/airflow_v3.py - Airflow 3.x (/api/v2)

Related Files

  • @api-differences.md - V2 vs V3 field/endpoint differences
  • @patterns.md - Implementation patterns

Quick Reference

adapter = _get_adapter()
dags = adapter.list_dags(limit=100)
run = adapter.trigger_dag_run("my_dag", conf={"key": "value"})