# airflow

Скилл для работы с Apache Airflow через CLI af: список и запуск DAG, чтение логов задач, разбор ошибок импорта и парсинга.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 1500 установок · ★ 456
- Автор: astronomer
- Лицензия: Apache-2.0 · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/astronomer/agents/tree/HEAD/skills/airflow/SKILL.md
- Обновлён: 2026-10-14
- HTML: https://affpapa.org/nevibecode/skills/airflow

## Что делает

Скилл даёт агенту набор команд `af` для повседневных операций с Airflow. Посмотреть список DAG, запустить прогон, поставить его на паузу, прочитать лог упавшей задачи, проверить connections, variables и pools — всё это идёт через один интерфейс. Есть и прямой доступ к REST API через `af api <endpoint>`.

Внутри — справочник команд с описанием каждой, работа с несколькими инстансами через `af instance add`, `af instance use` и `af instance list`, плюс конфиг по образцу `git config` с уровнями global, project-shared и project-local. Токены можно держать в переменных окружения через синтаксис `${VAR}`. Этот скилл — точка входа: он перенаправляет к соседним скиллам для написания DAG, тестирования, деплоя и миграции с Airflow 2 на 3.

Команды рассчитаны на то, что `af` уже в PATH. Запускать можно через `astro otto` или поставить отдельно командой `uv tool install astro-airflow-mcp`. Автопоиск инстансов через `af instance discover` без `--dry-run` создаёт API-токены в Astro Cloud, поэтому сначала стоит прогнать предпросмотр и получить согласие. Для аналитики по метатаблицам Airflow и глубоких разборов первопричин есть отдельные скиллы — этот их не заменяет.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add astronomer/agents --skill airflow -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/airflow/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/airflow/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add astronomer/agents --skill airflow -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/airflow/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add astronomer/agents --skill airflow -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/airflow/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install astronomer/agents airflow
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/airflow/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add astronomer/agents --skill airflow -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/astronomer/agents --path skills/airflow
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/airflow/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add astronomer/agents --skill airflow -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/astronomer/agents/tree/HEAD/skills/airflow/SKILL.md

## Когда брать
- запустить DAG и дождаться завершения прогона
- прочитать лог упавшей задачи и понять причину
- разобрать ошибку импорта или парсинга DAG
- переключиться между prod и staging инстансами
- посмотреть connections, variables и pools

## Примеры запросов агенту
- Покажи список DAG и их последние прогоны
- Почему упал мой DAG? Посмотри логи задачи
- Запусти DAG daily_etl и дождись завершения

## Похожие
- [apache-airflow-orchestration](https://affpapa.org/nevibecode/skills/apache-airflow-orchestration.md) — скилл · 2400 установок
- [airflow-dag-patterns](https://affpapa.org/nevibecode/skills/airflow-dag-patterns.md) — скилл · 11000 установок
- [managed-airflow-dag-authoring](https://affpapa.org/nevibecode/skills/managed-airflow-dag-authoring.md) — скилл · 4100 установок
- [managed-airflow-dag-troubleshooting](https://affpapa.org/nevibecode/skills/managed-airflow-dag-troubleshooting.md) — скилл · 3500 установок
- [orchestration](https://affpapa.org/nevibecode/skills/orchestration.md) — скилл · 349800 установок
- [cargo-diagnostics](https://affpapa.org/nevibecode/skills/cargo-diagnostics.md) — скилл · 8700 установок

Из того же набора: [astronomer/agents](https://affpapa.org/nevibecode/by/astronomer/agents.md) — 23 карточки

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md