CtrlK
BlogDocsLog inGet started
Tessl Logo

airflow-dag-patterns

Build production Apache Airflow DAGs with best practices for operators, sensors, testing, and deployment. Use when creating data pipelines, orchestrating workflows, or scheduling batch jobs.

60

Quality

68%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./plugins/data-engineering/skills/airflow-dag-patterns/SKILL.md
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 a strong skill description that concisely covers specific capabilities (DAGs, operators, sensors, testing, deployment), includes a clear 'Use when' clause with natural trigger terms, and is highly distinctive due to Airflow-specific terminology. It uses proper third-person voice and avoids vague language or buzzwords.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: building DAGs, using operators, sensors, testing, and deployment. These are concrete, domain-specific capabilities rather than vague abstractions.

3 / 3

Completeness

Clearly answers both 'what' (build production Airflow DAGs with best practices for operators, sensors, testing, deployment) and 'when' (explicit 'Use when' clause covering data pipelines, orchestrating workflows, scheduling batch jobs).

3 / 3

Trigger Term Quality

Includes strong natural keywords users would say: 'Airflow', 'DAGs', 'data pipelines', 'orchestrating workflows', 'scheduling batch jobs', 'operators', 'sensors'. These cover the primary terms a user would naturally use when needing this skill.

3 / 3

Distinctiveness Conflict Risk

Highly distinctive due to the specific mention of 'Apache Airflow', 'DAGs', 'operators', and 'sensors' — these are unique to the Airflow ecosystem and unlikely to conflict with other skills. The combination of these terms creates a clear niche.

3 / 3

Total

12

/

12

Passed

Implementation

37%

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

The skill provides a reasonable starting point with a working DAG example and useful best practices, but falls short on several fronts. It promises coverage of testing, deployment, custom operators, sensors, and debugging but delivers concrete guidance on almost none of these. The lack of any sequenced workflow for building and deploying DAGs, combined with an unverifiable reference to a details file, significantly limits its production utility.

Suggestions

Add a clear multi-step workflow for creating, testing, validating, and deploying a DAG (e.g., 1. Write DAG → 2. Run `airflow dags test` → 3. Validate with `airflow dags list` → 4. Deploy to dags folder → 5. Monitor in UI).

Provide concrete, executable examples for at least testing (e.g., `pytest` DAG validation snippet) and custom operators, since these are listed as core use cases.

Either include the `references/details.md` bundle file or remove the reference and inline the most critical patterns directly.

Remove the 'When to Use This Skill' section and the Core Concepts table of principles Claude already understands to improve conciseness.

DimensionReasoningScore

Conciseness

The skill is mostly efficient but includes some unnecessary content like the 'Core Concepts' table explaining idempotency and atomicity—concepts Claude already knows. The 'When to Use This Skill' section is also largely redundant given the skill description. However, the code examples and best practices lists are reasonably tight.

2 / 3

Actionability

The Quick Start provides a fully executable DAG example, which is good. However, the skill lacks concrete examples for many of the patterns it mentions (custom operators, sensors, testing, deployment, debugging). The task dependency section shows syntax but not complete executable examples. Key promised topics like testing DAGs locally and production deployment have no concrete guidance.

2 / 3

Workflow Clarity

There is no clear multi-step workflow for creating, testing, validating, or deploying a DAG. The skill describes what to do (design principles, best practices) but never sequences the steps of building and deploying a DAG pipeline. For a skill covering production deployment and debugging, the absence of any validation checkpoints or sequenced workflow is a significant gap.

1 / 3

Progressive Disclosure

The skill references `references/details.md` for detailed patterns, which is good structure in principle. However, no bundle files are provided, so the reference is unverifiable and potentially a dead link. The main file itself mixes overview-level content with inline code that could be better organized, and the reference to details.md is vague ('Read that file when the navigation tier above is insufficient').

2 / 3

Total

7

/

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