testing-dags

SKILL.md

Iterative test-debug-fix cycles for Airflow DAGs with comprehensive failure diagnosis.

Start with af runs trigger-wait <dag_id> to run a DAG and wait for completion; no pre-flight checks needed

On failure, use af runs diagnose for comprehensive failure summary and af tasks logs to inspect error details from specific tasks

Supports custom configuration, timeouts, and retry attempts; handles success, failure, and timeout scenarios with clear response interpretation

Quick validation available via astro dev parse and astro dev pytest for fast feedback without a running Airflow instance

DAG Testing Skill

Use af commands to test, debug, and fix DAGs in iterative cycles.

Running the CLI

These commands assume af is on PATH. Run via astro otto to get it automatically, or install standalone with uv tool install astro-airflow-mcp.

Quick Validation with Astro CLI

If the user has the Astro CLI available, these commands provide fast feedback without needing a running Airflow instance:

# Parse DAGs to catch import errors, syntax issues, and DAG-level problems
astro dev parse