CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

configuring-airflow-language-sdks

Configures Airflow to run language SDK tasks (Java, Go, and future native SDKs) — register a coordinator, map a queue to it, ensure the runtime/artifact on workers, and tune coordinator options. Use when the user wants Airflow to route a queue to a native-language coordinator, asks about the `[sdk]` `coordinators`/`queue_to_coordinator` settings, `AIRFLOW__SDK__COORDINATORS`, `jars_root`, `executables_root` or other coordinator `kwargs`, `task_startup_timeout`, or why their native tasks aren't being picked up. Covers the shared routing mechanism plus per-coordinator options (e.g. JavaCoordinator, ExecutableCoordinator).

76

Quality

95%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

88%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-crafted configuration skill: executable configs in both cfg and env-var forms, parameter tables with defaults, an explicit verification checklist, and a symptom-based troubleshooting table. The only weaknesses are minor — slight duplication in the env-var example, a logging paragraph that edges into the Java deploy skill's territory, and no offloading of per-coordinator detail into reference files.

Suggestions

Trim the Option B env-var example to a single coordinator registration instead of repeating the full multi-coordinator JSON already shown in Option A, keeping only the one-line-JSON flattening demonstration.

Move the JUL `logging.properties` / `jvm_args` recipe into the deploying-java-sdk-bundles skill (or a java reference file) and keep only a one-line pointer here, since the logging-integration setup detail already lives there.

As new language SDKs land, split each coordinator's parameter table into per-coordinator reference files (e.g. references/java.md, references/executable.md) so SKILL.md stays a routing-and-overview document.

DimensionReasoningScore

Conciseness

The body is efficient — no explanation of concepts Claude already knows (no 'what is Airflow'), tight tables, and every section earns its place. Minor trimmable instances keep it below the top anchor: the Option B example repeats the full coordinators JSON from Option A in flattened form, and the JUL `logging.properties` paragraph drifts into deploy-skill logging-integration territory.

4 / 5

Actionability

Fully executable guidance: complete `airflow.cfg` blocks, ready-to-export env-var strings with the 'valid one-line JSON' gotcha called out, per-parameter tables with defaults and required flags, concrete verification commands (`java -version` via `astro dev bash` or `docker compose exec`), and a symptom→fix troubleshooting table. Copy-paste ready and covers the common cases.

5 / 5

Workflow Clarity

The implicit sequence (prerequisites → register coordinator → map queue → per-coordinator kwargs → verify → troubleshoot) is clearly sectioned, and 'Verifying the configuration' is an explicit numbered validation checklist with an expected outcome ('you should see the subprocess start and your task output'). The troubleshooting table provides error-recovery feedback loops (symptom → likely cause → fix), matching the top anchor.

5 / 5

Progressive Disclosure

Good single-file structure with clear headers, well-signaled links to sibling skills (authoring-*/deploying-*) and a Related Skills index. However, no bundle files exist and all per-coordinator detail (parameter tables, the JUL logging recipe) is inlined; as more coordinators land (the body itself anticipates 'Add a subsection here as new language SDKs land'), this content belongs in per-coordinator reference files, which is the minor organization gap versus the top anchor.

4 / 5

Total

18

/

20

Passed

Description

100%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: third-person, concrete actions, an explicit 'Use when' clause with exact setting names and a symptom-based trigger, and a clearly delimited niche (routing/config vs. authoring vs. deploying). It matches the good-overall-example pattern without padding.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — "register a coordinator, map a queue to it, ensure the runtime/artifact on workers, and tune coordinator options" — plus the exact config surfaces (`coordinators`, `queue_to_coordinator`, `jars_root`, `executables_root`). This matches the top anchor's comprehensive coverage; the score-4 anchor requires 'minor gaps in coverage' and none are evident for this skill's scope.

5 / 5

Completeness

Explicitly answers both questions: the 'what' is "Configures Airflow to run language SDK tasks... register a coordinator, map a queue to it..." and the 'when' is a full "Use when the user wants..." clause with concrete triggers. This is the anchor-5 pattern; the explicit trigger clause means it is not capped at 3.

5 / 5

Trigger Term Quality

Covers the natural phrasings a user would actually say: "route a queue to a native-language coordinator", "why their native tasks aren't being picked up", plus exact identifiers like `AIRFLOW__SDK__COORDINATORS`, `task_startup_timeout`, JavaCoordinator/ExecutableCoordinator, Java, Go, and Airflow. Both symptom-based and setting-based triggers are present, matching the comprehensive-synonyms anchor.

5 / 5

Distinctiveness Conflict Risk

Clear niche — coordinator/queue routing configuration — with distinct triggers (specific `[sdk]` setting names and env vars) that would not fire for sibling authoring/deploying skills. Distinct from generic Airflow-deployment skills because the triggers name coordinator-specific keys.

5 / 5

Total

20

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

astronomer/agents

Path

skills/configuring-airflow-language-sdks/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.