К основному содержанию
скилл CX Codex

airflow-expert — скилл для Claude Code: что делает и как установить

Скилл airflow-expert для Claude Code проектирует и разбирает Apache Airflow DAG, зависимости задач, операторы, сенсоры и расписания. Помогает работать с пайплайнами данных.

Apache-2.0 174 установок ★ 45 обновлён 2026-10-12

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add personamanagmentlayer/pcl --skill airflow-expert -a claude-code
Открыть на GitHub

Что делает airflow-expert

Скилл даёт агенту знания об Apache Airflow: проектирование DAG, связи между задачами, ветвление, динамическое создание задач, операторы, сенсоры и XCom. Он также охватывает расписания, повторы, тайм-ауты, пулы задач и обработку ошибок.

Внутри есть правила для TaskFlow API, идемпотентных DAG и отложенного режима сенсоров. Скилл подсказывает, как не выполнять тяжёлый код при каждом разборе файла DAG, хранить секреты в Connections и Secrets Backend, настраивать оповещения и вести логи. Дополнительные материалы лежат в references/CORE_CONCEPTS.md.

Для работы нужен Apache Airflow версии >=2.8.0. Доступные инструменты скилла: Read, Write, Edit, Bash, Glob и Grep, поэтому агент может читать и менять файлы проекта, а также запускать команды.

Какие задачи решает

  • спроектировать DAG для пайплайна данных
  • настроить зависимости и ветвление задач
  • добавить динамическое создание задач
  • подобрать операторы и сенсоры для workflow
  • разобрать повторы, тайм-ауты и сбои задач

Примеры запросов агенту

  • Спроектируй DAG для загрузки данных и объясни зависимости между задачами.
  • Проверь этот DAG: найди тяжёлый код верхнего уровня и предложи исправление.
  • Добавь в workflow динамическое создание задач, XCom и обработку ошибок.

Как установить airflow-expert

1Через Skills CLI (Vercel)

npx skills add personamanagmentlayer/pcl --skill airflow-expert -a claude-code

2Вручную: положить файлы

~/.claude/skills/airflow-expert/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/airflow-expert/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об airflow-expert

Как установить airflow-expert в Claude Code?

Выполните npx skills add personamanagmentlayer/pcl --skill airflow-expert -a claude-code, затем проверьте файл ~/.claude/skills/airflow-expert/SKILL.md.

Что делает airflow-expert?

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

Какая версия Apache Airflow нужна для airflow-expert?

Для работы нужен Apache Airflow версии >=2.8.0.

Исходный текст

SKILL.md · Apache-2.0
---
name: airflow-expert
version: 1.1.0
description: >-
  Expert-level Apache Airflow orchestration, DAGs, operators, sensors, XComs, task
  dependencies, and scheduling. Use when the user mentions orchestration, DAGs, workflow,
  scheduling, or data pipeline, or when the task involves DAG Fundamentals, Task
  Dependencies and Branching, Dynamic Task Generation, or Operators and Sensors.
category: data
author: PCL Team
license: Apache-2.0
tags:
  - airflow
  - orchestration
  - dag
  - workflow
  - scheduling
  - data-pipeline
allowed-tools:
  - Read
  - Write
  - Edit
  - Bash
  - Glob
  - Grep
requirements:
  apache-airflow: '>=2.8.0'
---

# Apache Airflow Expert

You are an expert in Apache Airflow with deep knowledge of DAG design, task orchestration, operators, sensors, XComs, dynamic task generation, and production operations. You design and manage complex data pipelines that are reliable, maintainable, and scalable.

## Best Practices

### 1. DAG Design

- Keep DAGs simple and focused on single workflows
- Use TaskFlow API for cleaner code and automatic XCom handling
- Set catchup=False for new DAGs to avoid backfilling
- Use meaningful task_ids and add documentation
- Make DAGs idempotent for safe reruns

### 2. Task Configuration

- Set appropriate retries and retry_delay
- Use execution_timeout to prevent stuck tasks
- Configure proper depends_on_past for sequential processing
- Use pools to limit concurrent tasks
- Set priority_weight for critical tasks

### 3. Performance

- Minimize DAG file size and complexity
- Avoid top-level code that executes on every parse
- Use dynamic task mapping instead of creating many tasks
- Leverage sensors with reschedule mode for long waits
- Use task pools to prevent resource exhaustion

### 4. Production Operations

- Monitor DAG run duration and SLA misses
- Set up alerting for failures
- Use Variables and Connections instead of hardcoded values
- Enable DAG versioning and testing
- Implement proper logging

### 5. Security

- Store credentials in Connections, not code
- Use Secrets Backend (AWS Secrets Manager, Vault)
- Limit access with RBAC
- Audit DAG changes
- Encrypt sensitive XCom data

## Anti-Patterns

### 1. Non-Idempotent DAGs

```python
# Bad: Using current date
@task
def extract():
    today = datetime.now().date()
    return extract_data_for_date(today)

# Good: Using execution date
@task
def extract(**context):
    date = context['ds']
    return extract_data_for_date(date)
```

### 2. Heavy Top-Level Code

```python
# Bad: Expensive operation at top level
expensive_config = fetch_config_from_api()  # Runs on every parse

dag = DAG(...)

# Good: Load config in task
@task
def get_config():
    return fetch_config_from_api()
```

### 3. Not Using Connections

```python
# Bad: Hardcoded credentials
DATABASE_URL = "postgresql://user:pass@host:5432/db"

# Good: Use Airflow Connection
conn = BaseHook.get_connection('postgres_default')
```

### 4. Ignoring Task Failures

```python
# Bad: No retry or alert configuration
@task
def important_task():
    critical_operation()

# Good: Proper error handling
@task(retries=3, on_failure_callback=alert_team)
def important_task():
    critical_operation()
```

## Reference Documentation

Detailed material lives alongside this skill and is read on demand:

- [Core Expertise](references/CORE_CONCEPTS.md) — DAG Fundamentals, Task Dependencies and Branching, Dynamic Task Generation, Operators and Sensors, XComs and Task Communication, Connections and Variables, Error Handling and Retries, Production Best Practices

## Resources

- [Apache Airflow Documentation](https://airflow.apache.org/docs/)
- [Airflow Best Practices](https://airflow.apache.org/docs/apache-airflow/stable/best-practices.html)
- [TaskFlow API](https://airflow.apache.org/docs/apache-airflow/stable/tutorial/taskflow.html)
- [Airflow Providers](https://airflow.apache.org/docs/apache-airflow-providers/)
- [Astronomer Guides](https://docs.astronomer.io/learn)
- [Airflow GitHub](https://github.com/apache/airflow)
- [Airflow Slack Community](https://apache-airflow-slack.herokuapp.com/)

© PCL Team · Apache-2.0 · personamanagmentlayer/pcl

Похожие скиллы

Все скиллы по теме «Данные и базы» →
apache-airflow-orchestration reason-machines Скилл apache-airflow-orchestration даёт агенту знания по Apache Airflow: сборка DAG, расписания, операторы, сенсоры, разбор падений задач. CX Codex +1 2 400установок airflow astronomer Скилл для работы с Apache Airflow через CLI af: список и запуск DAG, чтение логов задач, разбор ошибок импорта и парсинга. CX Codex +1 1 500установок airflow-hitl astronomer Скилл airflow-hitl для Claude Code собирает HITL-воркфлоу в Airflow: согласование, ввод формы и ветвление по выбору человека. DAG ждёт ответа из UI. CX Codex +1 1 000установок airflow-dag-patterns Seth Hobson Скилл airflow-dag-patterns для Claude Code помогает проектировать DAG в Apache Airflow, связывать задачи и проверять пайплайны. Используется при работе с ETL, пакетными заданиями и отладкой запусков. CX Codex +1 11 000установок managed-airflow-dag-authoring официальный google Скилл managed-airflow-dag-authoring помогает создавать и проверять DAG Apache Airflow для Managed Service for Apache Airflow. Нужен при разработке или расширении DAG. CX Codex +1 4 100установок managed-airflow-dag-troubleshooting официальный google Скилл managed-airflow-dag-troubleshooting разбирает сбои DAG run и task instance в Managed Service for Apache Airflow по логам, состояниям задач и исходному коду DAG. CX Codex +1 3 500установок

Из того же набора104

Весь набор →
azure-expert Скилл azure-expert помогает проектировать архитектуру в Microsoft Azure, писать код для Azure Functions и Cosmos DB, а также генерировать команды Azure CLI. CX Codex +1 180установок dbt-expert Скилл dbt-expert для Claude Code помогает проектировать dbt-модели, тесты, документацию, макросы и Jinja-шаблоны. Решает задачи аналитической инженерии и SQL-преобразований. CX Codex +1 180установок rust-expert Скилл rust-expert для Claude Code задаёт ИИ-агенту роль Rust-разработчика: владение, лайфтаймы, async и обработка ошибок. Разбирает неочевидные ошибки borrow checker. CX Codex +1 179установок design-expert Скилл design-expert даёт агенту паттерны системного дизайна, масштабирования и распределённых систем с готовыми примерами кода на Python. CX Codex +1 178установок cloudflare-expert Скилл cloudflare-expert для Claude Code помогает с Workers, CDN, периферийными вычислениями и защитой Cloudflare. Активируется в задачах про WAF, сервисы Cloudflare и их инструменты разработки. CX Codex +1 174установок codeql-expert Скилл codeql-expert помогает писать и запускать запросы CodeQL, искать уязвимости и подключать анализ к GitHub Code Scanning. Работает с несколькими языками. CX Codex +1 174установок skill-creator-expert Скилл skill-creator-expert помогает проектировать, писать и проверять скиллы PCL: разбирает предметную область, собирает структуру и прогоняет готовый файл по чек-листу качества. CX Codex +1 173установок django-expert Скилл django-expert помогает проектировать веб-приложения на Django: модели ORM, представления, формы, маршруты и API на Django REST Framework. CX Codex +1 172установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой