blueprint

Define reusable Airflow task group templates with Pydantic validation and compose DAGs from YAML. Use when creating blueprint templates, composing DAGs from YAML, validating configurations, or enabling no-code DAG authoring for non-engineers.

Quality

—

Does it follow best practices?

Impact

—

No eval scenarios have been run

Securityby

Passed

No known issues

Quality

Content

77%

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

The content is highly actionable with executable examples, clear routing, and validation checkpoints, but it is a long monolithic document with some inter-section repetition and no split-out reference files for the detailed material.

Suggestions

Move the detailed Troubleshooting entries and Validation/Schema command reference into a separate reference file (e.g. troubleshooting.md), keeping SKILL.md as an overview with one-level-deep links to improve progressive disclosure.

De-duplicate guidance repeated across Project Setup and Troubleshooting (build_all_dags rename, uvx --with provider packages) by stating it once and cross-referencing, to reduce token cost.

Tighten prose around the library-specific rules where the same constraint is restated in both narrative and table form.

Dimension	Reasoning	Score
Conciseness	The body is largely operational specifics about a niche library that earn their place, but at ~715 lines it repeats guidance across sections — e.g. the build_all_dags rename and the uvx --with provider-packages note each appear in both Project Setup and Troubleshooting — so it is mostly efficient but could be tightened.	2 / 3
Actionability	It provides copy-paste-ready Python, YAML, and shell examples plus exact uvx/curl commands throughout, matching the 'fully executable code/commands; copy-paste ready' anchor rather than the pseudocode level 2.	3 / 3
Workflow Clarity	A routing table sequences user intent to sections, the Validation Commands and Verification Checklist supply explicit checkpoints, and troubleshooting entries give cause/fix feedback loops, matching the 'clear sequence with explicit validation steps' anchor.	3 / 3
Progressive Disclosure	No reference bundle files exist and the skill is a single ~715-line monolith with detailed API/troubleshooting content kept inline that could be split into one-level-deep reference files, matching the 'content that should be separate is inline' anchor rather than the well-split level 3.	2 / 3
	Total	10 / 12 Passed

Description

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.

The description is specific, third-person, and supplies explicit trigger guidance covering the skill's main use cases. It cleanly answers both what the skill does and when to invoke it.

Dimension	Reasoning	Score
Specificity	Names multiple concrete actions — 'Define reusable Airflow task group templates with Pydantic validation and compose DAGs from YAML' — matching the 'lists multiple specific concrete actions' anchor rather than the partial domain-only level 2.	3 / 3
Completeness	It explicitly answers both what ('Define... templates... compose DAGs from YAML') and when ('Use when creating blueprint templates...'), with an explicit 'Use when' trigger clause as required for level 3.	3 / 3
Trigger Term Quality	The 'Use when creating blueprint templates, composing DAGs from YAML, validating configurations, or enabling no-code DAG authoring' clause covers natural phrasings a user would say, matching the 'good coverage of natural terms' anchor.	3 / 3
Distinctiveness Conflict Risk	The niche is clearly bounded to Airflow DAG composition from YAML via validated templates, with distinct triggers unlikely to fire for unrelated skills, matching the 'clear niche with distinct triggers' anchor.	3 / 3
	Total	12 / 12 Passed

Validation

93%

Warnings & errors only

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

Validation — 15 / 16 Passed

Validation for skill structure

Criteria	Description	Result
skill_md_line_count	SKILL.md is long (721 lines); consider splitting into references/ and linking	Warning

	Total	15 / 16 Passed

Repository: astronomer/agents
Commit: 8827e93

Reviewed: 8 days ago

Table of Contents

Discovery Implementation Validation

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.