One-click install
npx skills add https://github.com/miptah21/skills --skill airflow-miptah21
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: airflow
Source: https://github.com/miptah21/skills/tree/main/.agents/skills/airflow
Command: npx skills add https://github.com/miptah21/skills --skill airflow-miptah21

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you manage and troubleshoot Apache Airflow by letting you list DAGs, trigger runs, inspect task logs, and diagnose import or execution failures without guessing.

Core Features & Use Cases

  • Airflow operations via CLI: list DAGs, explore DAGs, get schedules/details, pause/unpause, and trigger runs (optionally waiting for completion).
  • Failure investigation: check import/parse errors, diagnose failed runs, and retrieve task logs to find the root cause.
  • Instance & configuration management: switch between multiple Airflow instances, manage connections/variables/pools, and verify health.
  • Scope note: route to related sub-skills for writing/testing DAGs, deployment, lineage/freshness checks, and Airflow 2→3 migration.

Example: When a DAG fails to appear because of an import/parse error, you can query Airflow for the specific error state, inspect logs for the failing task, and then iterate on the fix using the linked debugging/DAG authoring sub-skills.

Quick Start

Use this skill to trigger a DAG run and get the result by running the command af runs trigger-wait <dag_id>.

Frequently Asked Questions about airflow

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I trigger an Apache Airflow DAG run and wait for it to finish?

Trigger an Apache Airflow DAG run and wait for completion by using the `af runs trigger-wait <dag_id>` command. This executes the workflow and monitors the run lifecycle until it reaches a final state.

Why does my Airflow DAG fail to appear in the scheduler list?

An Airflow DAG may fail to appear due to an import or parse error. You can query the Airflow instance to retrieve the specific error state, inspect task logs, and diagnose the failing code before iterating on a fix.

How do I check task logs for a failed Apache Airflow run?

Check task logs for a failed Apache Airflow run by using the `af tasks` commands to retrieve detailed output. This allows you to inspect execution logs and find the root cause of the failure without guessing.

Can I switch between multiple Airflow instances to manage connections and variables?

Yes, you can switch between multiple Airflow instances to manage connections, variables, and pools. The instance configuration commands allow you to target different environments and verify their health status.

What is the best way to diagnose Apache Airflow import errors across instances?

Diagnose Apache Airflow import errors by checking the parse error state through the CLI. You can query the instance directly to identify the failing DAG file and inspect the specific exception causing the import failure.

Does this Airflow management approach handle DAG deployment and migration?

This approach handles DAG operations, run triggering, and log debugging, but routes deployment, lineage checks, and Airflow 2 to 3 migration to specialized sub-skills for those specific tasks.