CtrlK
BlogDocsLog inGet started
Tessl Logo

airflow-hitl

Use when the user needs human-in-the-loop workflows in Airflow (approval/reject, form input, or human-driven branching). Covers ApprovalOperator, HITLOperator, HITLBranchOperator, HITLEntryOperator, HITLTrigger. Requires Airflow 3.1+. Does not cover AI/LLM calls (see airflow-ai).

100

Quality

100%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

Quality

Discovery

100%

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

This is an excellent skill description that clearly defines its scope, includes natural trigger terms, explicitly states when to use it, and proactively distinguishes itself from related skills. The inclusion of specific operator names, version requirements, and an explicit exclusion boundary makes it highly actionable for skill selection. It follows all best practices including third-person voice and concise structure.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions and components: 'approval/reject, form input, human-driven branching' and names specific operators like ApprovalOperator, HITLOperator, HITLBranchOperator, HITLEntryOperator, HITLTrigger. Also specifies version requirement (Airflow 3.1+).

3 / 3

Completeness

Explicitly answers both 'what' (human-in-the-loop workflows covering approval/reject, form input, branching with specific operators) and 'when' ('Use when the user needs human-in-the-loop workflows in Airflow'). Also includes a helpful exclusion boundary ('Does not cover AI/LLM calls').

3 / 3

Trigger Term Quality

Includes strong natural keywords users would say: 'human-in-the-loop', 'approval', 'reject', 'form input', 'branching', 'Airflow', plus specific operator names. The abbreviation 'HITL' and full phrase 'human-in-the-loop' cover common variations. The exclusion note mentioning 'AI/LLM calls' also helps prevent false triggers.

3 / 3

Distinctiveness Conflict Risk

Highly distinctive with a clear niche: HITL workflows specifically in Airflow 3.1+. The explicit exclusion of AI/LLM calls with a cross-reference to 'airflow-ai' actively prevents conflicts with related skills. The specific operator names further narrow the scope.

3 / 3

Total

12

/

12

Passed

Implementation

100%

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

This is an excellent skill that demonstrates best practices throughout. It solves the version-drift problem elegantly by teaching Claude to discover live signatures rather than hardcoding parameters, keeping the skill durable across Airflow releases. The 6-step workflow is clear, the code examples are executable, the safety checklist is thorough, and the cross-references are well-organized.

DimensionReasoningScore

Conciseness

The skill is lean and efficient throughout. It assumes Claude's competence with Python and Airflow, never explains what HITL means conceptually, and every section earns its place. The repeated emphasis on discovering live signatures rather than hardcoding is a space-efficient pattern that avoids bloating the file with parameter lists.

3 / 3

Actionability

Provides fully executable code examples (the approval gate DAG, registry discovery commands, API response pattern), concrete bash commands for every discovery step, and specific patterns for Markdown body templating. The code is copy-paste ready and the discovery commands are complete with jq filters.

3 / 3

Workflow Clarity

The 6-step workflow is clearly sequenced: pick capability → discover signatures → write code → understand behavior → integrate externally → validate with safety checks. Step 6 provides an explicit checklist for validation, and the skill includes feedback loops (e.g., 'if the registry shows a param not mentioned here, prefer the registry'). The emphasis on verifying before writing code is a strong validation checkpoint.

3 / 3

Progressive Disclosure

The skill is well-structured as an overview with clear cross-references to related skills (airflow, airflow-ai, authoring-dags, testing-dags) and dynamically discovered docs URLs. Content is appropriately scoped — detailed registry usage is deferred to the airflow skill, AI patterns to airflow-ai. References are one level deep and clearly signaled.

3 / 3

Total

12

/

12

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
astronomer/agents
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.