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).
77
96%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Passed
No known issues
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, provides specific trigger terms, and explicitly states both when to use it and when not to use it. The inclusion of specific operator names, version requirements, and a cross-reference to a related skill (airflow-ai) makes it highly distinctive and actionable for skill selection.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions and components: approval/reject workflows, form input, human-driven branching, and names five specific operators/triggers (ApprovalOperator, HITLOperator, HITLBranchOperator, HITLEntryOperator, HITLTrigger). | 3 / 3 |
Completeness | Explicitly answers both 'what' (human-in-the-loop workflows covering specific operators for approval, forms, branching) 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, see airflow-ai'). | 3 / 3 |
Trigger Term Quality | Includes strong natural trigger terms users would say: 'human-in-the-loop', 'approval', 'reject', 'form input', 'human-driven branching', 'HITL', plus specific operator names. Also includes 'Airflow 3.1+' as a version qualifier. These are terms a user working with Airflow HITL workflows would naturally use. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive with a clear niche (HITL workflows in Airflow), specific operator names as triggers, version requirement (3.1+), and an explicit boundary distinguishing it from the airflow-ai skill. Very unlikely to conflict with other skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
92%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 a sophisticated approach to version-resilient documentation by teaching Claude to discover live API signatures rather than hardcoding potentially stale parameter lists. The 6-step workflow is clear, well-sequenced, and includes a thorough validation checklist. The only minor weakness is that all content is inline with no bundle files for progressive disclosure, though the content length is reasonable and the dynamic discovery pattern reduces the need for detailed reference material.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is lean and efficient throughout. It assumes Claude knows Python, Airflow concepts, and REST APIs. No unnecessary explanations of what HITL means or how deferrable operators work internally. Every section earns its place with actionable content. | 3 / 3 |
Actionability | Provides fully executable code examples (the approval gate DAG, bash discovery commands, API response pattern), concrete jq filters for registry discovery, and a complete safety checklist. The emphasis on discovering live signatures rather than hardcoding stale params is a sophisticated, highly actionable pattern. | 3 / 3 |
Workflow Clarity | The 6-step sequence is clearly ordered and logically dependent (pick capability → discover signatures → write code → understand behavior → integrate externally → validate). Step 6 provides an explicit validation checklist covering version checks, param drift, branching correctness, defaults/options consistency, and timeout configuration — strong feedback loop for error prevention. | 3 / 3 |
Progressive Disclosure | The content is well-structured with clear sections and cross-references to related skills (airflow, airflow-ai, authoring-dags, testing-dags). However, there are no bundle files to offload detailed content to, and some sections (like the behavior contracts in Step 4) are moderately lengthy inline. The dynamic registry discovery approach partially compensates by keeping the skill from needing to maintain detailed parameter references, but the skill could benefit from splitting the notifiers/auth/callbacks details into a separate reference file. | 2 / 3 |
Total | 11 / 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.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
535a040
Table of Contents
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.