airflow

SKILL.md

Query, manage, and troubleshoot Apache Airflow DAGs, runs, tasks, and system configuration.

Supports 30+ commands across DAG inspection, run management, task logging, configuration queries, and direct REST API access

Manage multiple Airflow instances with persistent configuration; auto-discover local and Astro deployments

Trigger DAG runs synchronously (wait for completion) or asynchronously, diagnose failures, clear runs for retry, and access task logs with retry/map-index filtering

Output JSON by default for programmatic filtering; includes high-level commands for common workflows plus low-level af api access for custom endpoints like XCom and event logs

Airflow Operations

Use af commands to query, manage, and troubleshoot Airflow workflows.

Astro CLI

The Astro CLI is the recommended way to run Airflow locally and deploy to production. It provides a containerized Airflow environment that works out of the box:

# Initialize a new project
astro dev init

# Start local Airflow (webserver at http://localhost:8080)
astro dev start

# Parse DAGs to catch errors quickly (no need to start Airflow)
astro dev parse