← ClaudeAtlas

astro-airflowlisted

Inspect and debug Airflow on Astronomer (Astro) deployments - DAG runs, task logs, container logs, env vars, and deployment state. Use when the user mentions Astro/Astronomer, asks about DAG runs or task logs on staging/prod, says 'check the deployment', references `astro deployment`, an Astro deployment ID, or a *.astronomer.run URL. Prefers the `af` CLI for DAG-level data and `astro` CLI for platform ops; curl is the fallback. Local astro dev -> vd:managing-astro-local-env. YAML DAG authoring -> vd:dag-factory. 'use Otto' / Airflow 2→3 upgrades -> vd:delegating-to-otto.
vanducng/skills · ★ 7 · AI & Automation · score 81
Install: claude install-skill vanducng/skills
# astro-airflow Read-only debugging surface for Airflow on Astro. Pair three tools: | Need | Tool | |---|---| | DAG runs, task logs, import errors, health, connections, variables, pools | `af` (Airflow REST wrapper) | | Container logs, deployment inspect, env vars, hibernate/wake | `astro deployment ...` | | Local `astro dev start` / parse / scheduler restart | `vd:managing-astro-local-env` | | Create or edit YAML DAGs | `vd:dag-factory` | | User says "use Otto", long audit, Airflow 2→3 upgrade | `vd:delegating-to-otto` | | Deep RCA after logs are in hand | `vd:debug` then `vd:fix` | | `af` not installed or no remote instance configured | curl against `/api/v2/` (Airflow 3) or `/api/v1/` (Airflow 2) | ## Prerequisites - `astro` CLI ≥ 1.42, logged in (`astro login`; verify with `astro context list`) - `curl` + `jq` - `af` optional but preferred: `uv tool install astro-airflow-mcp` (one-shot: `uvx --from astro-airflow-mcp af`) - A Deployment / Workspace / Organization API token in gopass for curl fallback. Mint via Astro UI → Deployment → Access → API Tokens. Least-privilege: `deployment.get` + `deployment.airflow.*.get`. Always resolve the live deployment ID first. IDs in project docs go stale. ```bash astro deployment list astro deployment inspect <deployment-id> --key metadata.airflow_api_url ``` ## Choose the interface 1. **Named Otto / upgrade / long investigation** → `vd:delegating-to-otto`. 2. **`af` on PATH (or `uvx --from astro-airflow-mcp af`) and a configured