airflow: Skill for Claude Code

.agents/skills/airflow-new-sdk/SKILL.md

airflow-new-sdk is a skill for Claude Code, Codex from apache/airflow. It costs 127 tokens per session (1,695 once invoked), scanned A, original, Apache-2.0.

A contributor guide for adding a new programming-language SDK to Apache Airflow, a system that schedules and runs data workflows. It covers the Python coordinator, communication between processes, package format, tests, and pull requests.

In plain words
What is it for?
Use it when adding Airflow support for a new language, including the coordinator, language-side communication code, package bundle, integration tests, and contribution changes.
Why use it?
It explains the repository rules and design choices so contributors do not have to work them out from scattered code. It helps keep a new language integration compatible with Airflow.

Skill for Claude CodeCodex ✓ vendor

Written for no agent in particular: nothing here depends on one. Also seen: installed under .agents/ (shared by several agents).

This is apache/airflow's own configuration. It tells Claude Code and Codex how to work on airflow itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything airflow configures →

About the project

Apache Airflow is a platform for defining, scheduling, and monitoring workflows as code, with a scheduler assigning dependent tasks to workers. Teams use it to orchestrate automated data and software pipelines and inspect their progress through a user interface. Its catalogue skills and instructions help agents work with Airflow.

apache/airflow · 47,377 stars · on GitHub · airflow.apache.org

Reuse

Borrowing it

Nothing to install: this file belongs to apache/airflow. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/apache/airflow/main/.agents/skills/airflow-new-sdk/SKILL.md
Clone the repo
git clone --depth 1 https://github.com/apache/airflow

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for airflow-new-sdk

README.md
[![agentmods](https://agentmods.dev/badge/skills/apache/airflow/airflow-new-sdk/github.svg)](https://agentmods.dev/skills/apache/airflow/airflow-new-sdk)
Your own site
<a href="https://agentmods.dev/skills/apache/airflow/airflow-new-sdk"><img src="https://agentmods.dev/badge/skills/apache/airflow/airflow-new-sdk/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for airflow-new-sdk

Your own site · 80×15
<a href="https://agentmods.dev/skills/apache/airflow/airflow-new-sdk"><img src="https://agentmods.dev/badge/skills/apache/airflow/airflow-new-sdk.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 127 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,695 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe. Third-party audits
  • Snyk pass 7 Sept 2026
  • NVIDIA SkillSpector pass 7 Sept 2026
How audits are shown
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00127 $0.01695
Opus 5.5 $0.00051 $0.00678
Sonnet 5.5 $0.00025 $0.00339
Haiku 4.5 $0.00013 $0.00169

Measured 2mo ago against content hash f098050628df, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

airflow-new-sdk scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2mo ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.agents/skills/airflow-new-sdk/SKILL.md · 161 lines

How it starts

The opening of the file, as written. The whole thing — 161 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Implementing a new language SDK for Airflow

Start here

Read contributing-docs/30_new_language_sdk.rst first. It is the authoritative contributor guide for this topic — coordinator base class choices, wire protocol spec, bundle footer format, and testing requirements. Everything in this skill builds on top of it, not alongside it.


Repository layout

Every new SDK needs two things. The coordinator (Python) goes here:

task-sdk/src/airflow/sdk/coordinators/<language>/
    __init__.py        # re-export + module docstring
    coordinator.py     # subclass of SubprocessCoordinator or BaseCoordinator
task-sdk/tests/coordinators/<language>/
    test_coordinator.py
task-sdk/tests/integration/coordinators/<language>/
    test_integration.py   # requires Breeze

The language SDK itself lives in a top-level <language>-sdk/ directory (like java-sdk/ and go-sdk/). For native-executable languages using ExecutableCoordinator, no coordinator code is needed at all.


Choosing the right base class — quick guide

Does the runtime compile to a self-contained native executable?
  YES → Use ExecutableCoordinator (zero Python to write).
        Append an AFBNDL01 footer with a packer tool (see go-sdk reference).
  NO  →
    Does it start via a single shell command (node, ruby, dotnet, …)?
      YES → Subclass SubprocessCoordinator.
            Implement _build_execute_task_command only (see 30_new_language_sdk.rst).
      NO  →
        Subclass BaseCoordinator and implement execute_task from scratch.
        (Rare: gRPC daemons, shared memory, persistent processes.)

The full rationale, method signature, and socket lifecycle for each path are in 30_new_language_sdk.rst. Read that section before writing any code.


Reference implementations to study

What to study Where
SubprocessCoordinator base class task-sdk/src/airflow/sdk/coordinators/_subprocess.py
Java coordinator (SubprocessCoordinator subclass) task-sdk/src/airflow/sdk/coordinators/java/coordinator.py
ExecutableCoordinator (native bundles) task-sdk/src/airflow/sdk/coordinators/executable/coordinator.py
Wire protocol in Kotlin java-sdk/sdk/src/main/kotlin/org/apache/airflow/sdk/execution/
Wire protocol in Go go-sdk/pkg/execution/
AFBNDL01 footer (Go reference) go-sdk/internal/bundlefooter/, task-sdk/docs/executable-bundle-spec.rst
All message types and field specs task-sdk/src/airflow/sdk/execution_time/schema/schema.json

Read the full file on GitHub · 161 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2mo ago First seen · 161 lines · 127 tokens per session scan A f098050628df

Subscribe to this mod's changes

airflow-new-sdk is a skill published in the GitHub repository apache/airflow (47,377 stars, last pushed yesterday), licensed Apache-2.0. It adds 127 tokens to every session and 1,695 once invoked, about $0.0005 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

airflow-new-sdk compared with skills from other repositories

airflow-new-sdk next to 6 skills from other repositories
ModTypeStarsLast pushLicenceScanTokensWorks with
airflow-new-sdkapache/airflowSkill47kyesterdayApache-2.0A127Claude Code, Codex
authoring-dagsastronomer/agentsSkill4584d agoApache-2.0A93Claude Code
codexerPracticalSwan/agent-skillsSkill2418d agoMITA38Codex
airflow-workflowDatus-ai/Datus-agentSkill1.9kyesterdaynoneA24Claude Code
create-pubsub-pythondiagrid-labs/dapr-skillsSkill1320d agoMITA70Claude Code
create-workflow-pythondiagrid-labs/dapr-skillsSkill1320d agoMITA49Claude Code
jamjet-durability-patternsjamjet-labs/jamjetSkill232d agoApache-2.0A36Claude Code, Codex