Official agent skill

Managed Airflow Dag Authoring

by google in google/skills

Provides guidance for authoring Apache Airflow DAGs in Managed Service for Apache Airflow (MSAA; formerly Cloud Composer).

OfficialApache-2.0Auto-check passedData & Analytics

Install Managed Airflow Dag Authoring

skills CLI
$ npx skills add google/skills --skill managed-airflow-dag-authoring -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install google/skills managed-airflow-dag-authoring --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/google/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/cloud/managed-airflow-dag-authoring .claude/skills/managed-airflow-dag-authoring && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
managed-airflow-dag-authoring
GitHub stars
21k
Token cost
~1.5k tokens
SKILL.md length
570 words
Files
1
Skills in repo
147
Repo updated
First seen
Licence
Apache-2.0

At a glance

Provides guidance for authoring Apache Airflow DAGs in Managed Service for Apache Airflow (MSAA; formerly Cloud Composer).

  • Works in 3 steps: Context Discovery → DAG Authoring Best Practices → Validation Process
  • Extending an Airflow DAG
  • SKILL.md covers Phase 1: Context Discovery, Phase 2: DAG Authoring Best…, Phase 3: Validation Process and Definition of Done
  • Calls ruff and gcloud

What it does

Managed Airflow Dag Authoring is an agent skill from google/skills, published by the product's own GitHub organization. Provides guidance for authoring Apache Airflow DAGs in Managed Service for Apache Airflow (MSAA; formerly Cloud Composer). Covers environment context discovery, Airflow 2 vs 3 compatibility, authoring best practices, and local/remote validation processes. Use when creating or extending an Airflow DAG. Don't use when authoring Python code unrelated to Airflow DAGs.

Its SKILL.md is about 1.5k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Data & Analytics, covering Data pipelines and ETL. It works with Apache Airflow and Python. The repository describes itself as: Agent Skills for Google products and technologies. The licence is Apache-2.0.

When your agent uses it

  • Extending an Airflow DAG
  • Authoring Python code unrelated to Airflow DAGs

Example prompts

  • “Use the managed-airflow-dag-authoring skill to provide guidance for authoring Apache Airflow DAGs in Managed Service for Apache Airflow (MSAA…”
  • “/managed-airflow-dag-authoring”

Requirements

  • Python 3

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. Context Discovery
  2. DAG Authoring Best Practices
  3. Validation Process

What it can do on your machine

Read from SKILL.md and the folder at commit 5120a76. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • ruff
    • gcloud

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use gcloud, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Managed Airflow Dag Authoring loads about 1.5k tokens when it runs. Until then it costs about 99 tokens; SKILL.md has 570 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~99
When it runs · the whole SKILL.md, loaded when a task matches
~1.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from google/skills at commit 5120a76, republished under its Apache-2.0 licence (© google). 570 words, ~1,460 tokens.

Download SKILL.mdSave it as .claude/skills/managed-airflow-dag-authoring/SKILL.md (or your agent's skills folder).
name
managed-airflow-dag-authoring
description
Provides guidance for authoring Apache Airflow DAGs in Managed Service for Apache Airflow (MSAA; formerly Cloud Composer). Covers environment context discovery, Airflow 2 vs 3 compatibility, authoring best practices, and local/remote validation processes. Use when creating or extending an Airflow DAG. Don't use when authoring Python code unrelated to Airflow DAGs.
metadata.version
1.0.0
metadata.category
BigDataAndAnalytics

GCP Managed Airflow DAG Authoring Guide

This skill guides you through authoring and validating Apache Airflow DAGs for Managed Service for Apache Airflow (MSAA; formerly Cloud Composer) environments.


Phase 1: Context Discovery

Before writing any DAG code, you MUST understand the constraints (e.g. version of Airflow) and capabilities of your target environment if user is willing to provide them.

1.1 Identify Target Environment & Access

Determine if you have direct access to the target Managed Airflow environment, local development environment or if you are working offline (only changing local files without validation).

  • If environment access is available: Use gcloud to inspect the environment (see Section 1.3).
  • If offline: Rely on user provided details.
1.2 Identify Development Environment

Determine if a local development environment is available.

  • Check if composer-dev CLI is installed.
  • Check if a local Python environment with airflow is available.
1.3 Inspect Target Environment (if available and requested)

Run the following commands to discover version constraints:

  1. Get Airflow/Image Version:

    bash
    gcloud composer environments describe {env_name} \
        --location {region} \
        --format="value(config.softwareConfig.imageVersion)"
  2. Get Installed Packages (Versions):

    bash
    gcloud composer environments describe {env_name} \
        --location {region} \
        --format="value(config.softwareConfig.pypiPackages)"
  3. Get DAGs GCS Bucket:

    bash
    gcloud composer environments describe {env_name} \
        --location {region} \
        --format="value(config.dagGcsPrefix)"

Phase 2: DAG Authoring Best Practices

2.1 General Airflow Best Practices
  • Idempotency: Every task SHOULD be idempotent. Running it multiple times with the same inputs (e.g., execution date) SHOULD produce the same result and not duplicate data.
  • No Top-Level Code Execution: Do NOT execute database queries, external API calls, or heavy computations at the top level of the DAG file (outside of tasks/operators). This code runs every few seconds during DAG parsing and will degrade performance.
  • Explicit Catchup: Always set catchup=False in the DAG definition unless historical backfilling is explicitly required.
  • Use Airflow Variables/Connections: Never hardcode credentials or environment-specific configs. Use Variable.get() (with deserialize_json=True if applicable) and BaseHook.get_connection(). Access variables via Jinja templates (e.g., {{ var.value.my_var }}) to avoid database calls during DAG parsing.
2.2 Airflow 2 vs Airflow 3 Compatibility

Use managed-airflow-migrations skill to navigate adjusting the code to specific target Airflow version.


Show full SKILL.md (231 more words)Show less

Phase 3: Validation Process

You MUST validate DAGs before concluding your task.

3.1 Local Validation (Offline/Pre-deployment)
3.1.1 Static Analysis & Linting

Use ruff or pylint if available.

bash
ruff check path/to/dag.py
  • If targeting Airflow 3, check with Airflow 3 rules if rulesets are available.
3.1.2 Local Dev Environment (composer-dev)

If the user has composer-dev configured:

  1. Copy the DAG to the local directory with DAGs:

    bash
    cp path/to/dag.py $(composer-dev describe {local_env} --format="value(dags_directory)")
  2. Verify parsing:

    bash
    composer-dev run-airflow-cmd {local_env} dags list-import-errors
3.2: Target Environment Validation

Only perform these steps if you have GCP access and are authorized to deploy to a target environment.

3.2.1 Deploy to GCS

Upload the DAG to the target environment's GCS bucket:

bash
gcloud storage cp path/to/dag.py gs://{target_bucket}/dags/
3.2.2 Verify via Airflow CLI

Wait 1-2 minutes for the scheduler to parse the file, then run:

  1. Check for Import Errors:

    bash
    gcloud composer environments run {env_name} \
        --location {region} \
        dags list-import-errors

Pass Criteria: Output should be "No data found" or empty.

  1. Verify DAG is Listed:

    bash
    gcloud composer environments run {env_name} \
        --location {region} \
        dags list | grep {dag_id}
3.2.3 Monitor Cloud Logging

Check for runtime parsing errors in Cloud Logging:

query
resource.type="cloud_composer_environment"
resource.labels.environment_name="{env_name}"
log_id("airflow-scheduler")
severity>=ERROR
textPayload:"{dag_file_name}"

Definition of Done

  • DAG code adheres to Airflow version constraints of the target environment.
  • DAG code follows best practices (no top-level execution, idempotent if possible).
  • DAG parses locally without import errors.
  • (If environment is available) DAG is deployed to the target environment and verified to have no import errors.

© google, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/cloud/managed-airflow-dag-authoring of google/skills.

Open the folder on GitHubat commit 5120a76

Compare with similar skills

Managed Airflow Dag Authoring next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Managed Airflow Dag Authoring compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Managed Airflow Dag Authoring this skillgoogle/skills21k—~1.5kAutomated safety check: PassApache-2.0
Senior Data Engineerbenchflow-ai/skillsbench1.8k—~5.9kAutomated safety check: PassMIT
Airflow DAG Patternswshobson/agents40k9 repos~784Automated safety check: PassMIT
Version Bumpergodatadriven/whirl205—~1.2kAutomated safety check: PassApache-2.0
Senior Data Engineeralirezarezvani/claude-skills28k3 repos~1.4kAutomated safety check: PassMIT
Authoring Go SDK Tasksastronomer/agents451—~2.1kAutomated safety check: PassApache-2.0

Similar skills

  • Senior Data Engineer

    benchflow-ai/skillsbench

    World-class data engineering skill for building scalable data pipelines, ETL/ELT systems, real-time streaming, and data infrastructure.

    1.8k GitHub stars~5.9k tokensUpdated 2 mo ago
    Data & AnalyticsAuto-check passed
  • Airflow DAG Patterns

    wshobson/agents

    Patterns for writing production-ready Apache Airflow DAGs: task dependencies, custom operators and sensors, local testing, and rules for what to avoid.

    40k GitHub starsUsed in 9 repos~784 tokens
    Data & AnalyticsAuto-check passed
  • Version Bumper

    godatadriven/whirl

    Bump the Airflow or Python version across all project files.

    205 GitHub stars~1.2k tokensUpdated 7 days ago
    Data & AnalyticsAuto-check passed
  • Senior Data Engineer

    alirezarezvani/claude-skills

    Data engineering skill for building scalable data pipelines, ETL/ELT systems, and data infrastructure.

    28k GitHub starsUsed in 3 repos~1.4k tokens
    Data & AnalyticsAuto-check passed
  • Authoring Go SDK Tasks

    astronomer/agents

    Writes Airflow task logic in Go using the Airflow Go SDK. An agent skill from astronomer/agents.

    451 GitHub stars~2.1k tokensUpdated yesterday
    Data & AnalyticsAuto-check passed
  • Senior Data Engineer

    davila7/claude-code-templates

    World-class data engineering skill for building scalable data pipelines, ETL/ELT systems, and data infrastructure.

    32k GitHub starsUsed in 1 repo~1.4k tokens
    Data & AnalyticsAuto-check passed

More from google/skills

All 147 skills in this repo
  • Official

    Query Cloud Trace spans, filter by latency thresholds or error status, correlate distributed traces with Cloud Logging, and diagnose latency bottlenecks across Google Cloud services.

    21k GitHub stars~1.7k tokensUpdated today
    Auto-check passed
  • Official

    Manages Google Cloud Privileged Access Manager entitlements and grants: create and edit entitlements, request temporary access, and approve or deny pending grants.

    21k GitHub stars~3.2k tokensUpdated today
    Auto-check passed
  • Official

    Writes Terraform alerting policies for AI agents that emit OpenTelemetry metrics, covering reliability, cost, safety, security and quality signals on Google Cloud.

    21k GitHub stars~4.2k tokensUpdated today
    Auto-check passed
  • Official

    Deploys open models or custom weights from Model Garden to Agent Platform endpoints, checks deployment status and cleans up endpoints, confirming before any change.

    21k GitHub stars~5k tokensUpdated today
    Auto-check passed
  • Official

    Searches, manages and scaffolds skills in the Gemini Enterprise Agent Platform Skill Registry using bundled Python scripts and Google Cloud credentials.

    21k GitHub stars~584 tokensUpdated today
    Auto-check passed
  • Designs GCP infrastructure as local Terraform, validates and scans it against best practices, then imports it to Application Design Center for deployment and troubleshooting.

    21k GitHub stars~4.4k tokensUpdated today
    Auto-check passed

Questions about Managed Airflow Dag Authoring

What does Managed Airflow Dag Authoring do?

Provides guidance for authoring Apache Airflow DAGs in Managed Service for Apache Airflow (MSAA; formerly Cloud Composer). Managed Airflow Dag Authoring is an agent skill from google/skills, published by the product's own GitHub organization. Provides guidance for authoring Apache Airflow DAGs in Managed Service for Apache Airflow (MSAA; formerly Cloud Composer).

When should I use Managed Airflow Dag Authoring?

Managed Airflow Dag Authoring fits situations like: extending an Airflow DAG; authoring Python code unrelated to Airflow DAGs.

How do I install Managed Airflow Dag Authoring in Claude Code?

Run `npx skills add google/skills --skill managed-airflow-dag-authoring -a claude-code`. Or copy the skill folder (skills/cloud/managed-airflow-dag-authoring in google/skills) into .claude/skills/managed-airflow-dag-authoring in your project. Claude Code loads it when a task matches its description.

How do I install Managed Airflow Dag Authoring in Codex?

Run `npx skills add google/skills --skill managed-airflow-dag-authoring -a codex`. Or copy the skill folder (skills/cloud/managed-airflow-dag-authoring in google/skills) into .agents/skills/managed-airflow-dag-authoring in your project. Codex loads it when a task matches its description.

Can I use Managed Airflow Dag Authoring in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add google/skills --skill managed-airflow-dag-authoring -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/managed-airflow-dag-authoring, .gemini/skills/managed-airflow-dag-authoring, .github/skills/managed-airflow-dag-authoring and .opencode/skills/managed-airflow-dag-authoring in your project.

What does Managed Airflow Dag Authoring need to run?

Going by SKILL.md and its folder, Managed Airflow Dag Authoring needs the command-line tools its instructions call (ruff and gcloud). Our summary lists: Python 3.

Does Managed Airflow Dag Authoring access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Managed Airflow Dag Authoring safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Managed Airflow Dag Authoring use?

Managed Airflow Dag Authoring is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Managed Airflow Dag Authoring use?

About 1.5k tokens (SKILL.md is roughly 5.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Managed Airflow Dag Authoring?

Skills that share tags, products or a category with Managed Airflow Dag Authoring: Senior Data Engineer (benchflow-ai/skillsbench, 1.8k stars), Airflow DAG Patterns (wshobson/agents, 40k stars), Version Bumper (godatadriven/whirl, 205 stars) and Senior Data Engineer (alirezarezvani/claude-skills, 28k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Managed Airflow Dag Authoring?

google (a GitHub organization, an official publisher) maintains it in google/skills, which has 21,069 GitHub stars. The repository holds 147 skills in this directory. The repository was last updated on October 9, 2026.

Source: google/skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.