CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

authoring-dags

Workflow and best practices for writing Apache Airflow DAGs. Use when creating a new DAG, write pipeline code, handling questions about DAG patterns and conventions or extending an existing DAG with a follow-up/downstream task. ANY request shaped like 'add a DAG named X', 'write a pipeline', 'add a task that runs after Y', or 'extend the DAG'. For testing and debugging DAGs, see the testing-dags skill.

66

Quality

83%

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

70%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.

The body excels at workflow sequencing with explicit validation checkpoints, user-consent gates, and iteration loops, and every phase is backed by concrete `af`/`astro` commands. It is dragged down by duplicated command tables and an ASCII diagram that restate other sections, and by a dangling `reference/best-practices.md` link that leaves the actual DAG-writing patterns unreachable in the bundle as shipped.

Suggestions

Fix the dangling link at the 'Best Practices & Anti-Patterns' section: `reference/best-practices.md` does not exist in the bundle (no references/ directory). Either include the file or inline the essential patterns.

Remove the redundant CLI Quick Reference table (it repeats the Phase 1 discovery commands and the validate commands verbatim) or keep only it, not both.

Replace the ~30-line ASCII workflow diagram with a one-line phase list; the six phases are each described immediately below it.

DimensionReasoningScore

Conciseness

Mostly efficient with no beginner-concept explanations, but there is visible duplication: the CLI Quick Reference table repeats most of the Phase 1 discovery table, Phase 5's "Quick Test (Minimal)" repeats the `af runs trigger-wait <dag_id> --timeout 300` command already given, and the ~30-line ASCII workflow diagram restates the six phase headings that follow it. Not 2 because each section still carries real guidance; this is tightening, not padding.

3 / 5

Actionability

Concrete, copy-paste-ready `af` commands with exact syntax throughout (`af dags errors`, `af dags get <dag_id>`, `af runs trigger-wait <dag_id> --timeout 300`, `astro deploy --dags`), plus clear if/then handling ("If your file appears -> fix and retry"). Not 5 because for a DAG-writing skill there is no example DAG/code snippet in the body, and the pointer that would carry code patterns (best-practices.md) is a dangling reference, leaving the implement phase with less executable guidance than the validate phase.

4 / 5

Workflow Clarity

The six phases are explicitly sequenced with a dedicated VALIDATE phase, per-step error checkpoints ("If your file appears -> fix and retry"), an ITERATE phase that loops back to validation, and a user-consent gate before triggering runs — matching the anchor's clear sequence with explicit validation steps and feedback loops for error recovery.

5 / 5

Progressive Disclosure

Section structure is clear and the heavy content (code patterns) is appropriately split into a one-level reference, but the sole bundle reference `reference/best-practices.md` does not exist — no `references/` (or `reference/`) directory is present in the bundle — so the primary navigation pointer is broken. Not 4 because the guideline says to score against the actual bundle structure, and the one referenced path is missing; not 2 because the body itself is not an inlined wall of reference content.

3 / 5

Total

15

/

20

Passed

Description

91%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, explicit what/when, and highly natural quoted trigger phrases that a user would verbatim say when needing DAG authoring help. The main weaknesses are the slightly abstract "Workflow and best practices" capability framing and the generic "write a pipeline" trigger that could collide with non-Airflow pipeline requests.

DimensionReasoningScore

Specificity

Names the domain ("writing Apache Airflow DAGs") and several concrete actions ("creating a new DAG", "write pipeline code", "extending an existing DAG with a follow-up/downstream task", "handling questions about DAG patterns and conventions"), but the opening "Workflow and best practices" framing is slightly abstract and lacks the comprehensive concrete-capability enumeration of the 5 anchor. Not 3 because more than 1-2 concrete actions are explicitly listed.

4 / 5

Completeness

Explicitly answers both: what ("Workflow and best practices for writing Apache Airflow DAGs") and when ("Use when creating a new DAG, ... or extending an existing DAG", reinforced by "ANY request shaped like 'add a DAG named X', 'write a pipeline'..."). It also adds a boundary pointer to testing-dags, matching the 5 anchor's concrete trigger phrases; 4 would require the 'when' to be less explicit, which it is not.

5 / 5

Trigger Term Quality

Comprehensive natural phrasings users would actually say: "add a DAG named X", "write a pipeline", "add a task that runs after Y", "extend the DAG", plus synonyms like "creating a new DAG" and "follow-up/downstream task". These match the explicit quoted-request pattern in the 5 anchor better than the 'a few natural terms missing' fit of 4.

5 / 5

Distinctiveness Conflict Risk

The Apache Airflow DAG authoring niche is clear and it explicitly delegates testing to the testing-dags skill, but the quoted triggers "write a pipeline" and "add a task that runs after Y" are generic enough to risk overlap with non-Airflow pipeline/orchestration requests. Not 5 due to that overlap risk; not 3 because the domain and sibling-skill boundary are otherwise distinct.

4 / 5

Total

18

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

relative_links

Relative link issues: 1 missing

Warning

Total

14

/

16

Passed

Repository

astronomer/agents

Path

skills/authoring-dags/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.