CtrlK
BlogDocsLog inGet started
Tessl Logo

airflow

Queries, manages, and troubleshoots Apache Airflow using the af CLI. Covers listing DAGs, triggering runs, reading task logs, diagnosing failures, debugging DAG import errors, checking connections, variables, pools, and monitoring health. Also routes to sub-skills for writing DAGs, debugging, deploying, and migrating Airflow 2 to 3. Use when user mentions "Airflow", "DAG", "DAG run", "task log", "import error", "parse error", "broken DAG", or asks to "trigger a pipeline", "debug import errors", "check Airflow health", "list connections", "retry a run", or any Airflow operation. Do NOT use for warehouse/SQL analytics on Airflow metadata tables — use analyzing-data instead.

94

Quality

92%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Advisory

Suggest reviewing before use

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 hits all the marks. It provides comprehensive specific actions, abundant natural trigger terms, explicit 'Use when' and 'Do NOT use' clauses, and clear boundaries to distinguish it from related skills. The description is thorough without being unnecessarily verbose.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: listing DAGs, triggering runs, reading task logs, diagnosing failures, debugging DAG import errors, checking connections, variables, pools, monitoring health, and routing to sub-skills for writing, debugging, deploying, and migrating.

3 / 3

Completeness

Clearly answers both 'what' (queries, manages, troubleshoots Airflow via af CLI with specific operations listed) and 'when' (explicit 'Use when...' clause with detailed trigger terms). Also includes a 'Do NOT use' boundary condition, which further strengthens completeness.

3 / 3

Trigger Term Quality

Excellent coverage of natural trigger terms users would say: 'Airflow', 'DAG', 'DAG run', 'task log', 'import error', 'parse error', 'broken DAG', 'trigger a pipeline', 'debug import errors', 'check Airflow health', 'list connections', 'retry a run'. These are highly natural phrases users would actually use.

3 / 3

Distinctiveness Conflict Risk

Highly distinctive with a clear niche around Apache Airflow CLI operations. The explicit exclusion clause ('Do NOT use for warehouse/SQL analytics on Airflow metadata tables — use analyzing-data instead') directly addresses potential overlap and reduces conflict risk.

3 / 3

Total

12

/

12

Passed

Implementation

85%

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

This is a strong, well-structured skill that serves as an effective hub for Airflow operations. Its greatest strengths are the highly actionable CLI examples, clear workflow sequences with validation steps, and excellent progressive disclosure to related skills. The main weakness is moderate verbosity — the User Intent Patterns section is extensive and partially redundant with the quick reference table, and the overall document is long enough that some consolidation could improve token efficiency.

Suggestions

Consider condensing the 'User Intent Patterns' section — it partially duplicates the Quick Reference table and could be reduced to just the non-obvious mappings (e.g., intent → sub-skill routing) rather than repeating direct command mappings.

DimensionReasoningScore

Conciseness

The skill is fairly comprehensive but includes some sections that could be tightened. The 'User Intent Patterns' section is quite long and somewhat redundant with the quick reference table. The instance configuration section is thorough but verbose. However, most content earns its place given the breadth of the CLI tool.

2 / 3

Actionability

Excellent actionability throughout — every command is concrete and copy-paste ready with real CLI syntax. The workflows section provides fully executable step-by-step sequences, and jq filtering examples show exact usage patterns. Registry discovery examples include complete jq pipelines.

3 / 3

Workflow Clarity

Multi-step workflows are clearly sequenced with numbered steps and logical progression (e.g., 'Investigate a Failed Run' goes from listing runs → diagnosing → reading logs → clearing to retry). The 'Validate DAGs Before Deploying' workflow provides validation checkpoints. The instance discover workflow includes an explicit safety checkpoint (--dry-run first, ask for consent).

3 / 3

Progressive Disclosure

Excellent progressive disclosure with a clear overview structure, quick reference table for scanning, and well-signaled one-level-deep references to sub-skills (authoring-dags, debugging-dags, deploying-airflow, etc.) and supplementary files (api-reference.md). The Related Skills table at the end provides clean navigation with 'Use when...' context.

3 / 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.

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.