Airflow

This wraps the `af` CLI for hands-on Airflow operations: listing DAGs, triggering runs, reading task logs, diagnosing failures, and checking system config like connections, variables, and pools. It also covers the Astro CLI for local development and deployment. The instance management is solid, you can switch between prod, staging, and local environments with persistent config that mirrors git's system/global/local scoping. When things break, `af runs diagnose` and `af dags errors` get you straight to the problem. It routes to separate skills for writing DAGs, debugging import errors, and deployments, so this stays focused on runtime operations. Use it when you need to see what's running, fix what's broken, or just poke around Airflow state without opening the web UI.

skills.sh installs: 1.5K
GitHub stars: 459
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add astronomer/agents --skill airflow --agent claude-code

Installs into .claude/skills of the current project.

Files

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

# Run pytest against your DAGs
astro dev pytest

# Deploy to production
astro deploy            # Full deploy (image + DAGs)
astro deploy --dags     # DAG-only deploy (fast, no image build)

For more details: