CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

blueprint

Define reusable Airflow task group templates with Pydantic validation and compose DAGs from YAML. Use when creating blueprint templates, composing DAGs from YAML, declaring shared variables or per-environment profiles, validating configurations, sharing templates as an installable package, or enabling no-code DAG authoring for non-engineers.

72

Quality

90%

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

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

A high-quality, deeply actionable skill body: executable examples, exact error remediation, and explicit validation loops throughout. Its main weakness is structure across files — everything lives inline in one long SKILL.md rather than being split into reference files for on-demand loading.

Suggestions

Move the Troubleshooting error catalog (and the Schema Generation / Loader Options reference detail) into references/ files (e.g., references/troubleshooting.md), keeping only the top few errors and pointers in SKILL.md.

Trim the rarely-needed plumbing options (search_path, pattern, register_globals, render_templates, template_context, bp_registry) into a short reference table or separate file.

Consider splitting the cross-referenced gotchas (params validation nuance, schema optional-field behavior) into a references/advanced.md so the core composition flow stays lean.

DimensionReasoningScore

Conciseness

The body is dense and assumes Claude's competence — tables for rules, blockquote gotchas ("The function name matters", "Write with -o/--output, not >"), and no padding explaining basics Claude already knows. Minor trimming is possible (e.g., the exhaustive plumbing list in Loader Options and some troubleshooting entries), keeping it below the 'lean and efficient' anchor.

4 / 5

Actionability

Guidance is fully executable throughout: a canonical blueprint example, complete YAML samples, exact CLI invocations ("uvx --from airflow-blueprint blueprint <command>", the --with provider-package fix), and named error classes with concrete remediation. Code blocks are copy-paste ready and cover the common cases.

5 / 5

Workflow Clarity

A routing table sequences user intent to sections, setup is ordered (install → loader → verify with `blueprint list`), and a Verification Checklist closes the loop with explicit validation commands (`blueprint lint`, `blueprint list`, DAG appears in Airflow UI). Troubleshooting entries form feedback loops (error → cause → fix → re-check), matching the top anchor.

5 / 5

Progressive Disclosure

Section structure and internal navigation are excellent, but the skill is a ~727-line monolith with zero bundle files — content that clearly belongs in separate reference files (the 100-line Troubleshooting catalog, Schema Generation nuances, Loader Options reference) is inlined in SKILL.md. It sits between 'content that should be separate is inline' (2) and 'most content appropriately placed' (4); the strong internal structure lifts it to 3.

3 / 5

Total

17

/

20

Passed

Description

92%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: concrete third-person capability statement followed by an explicit, varied 'Use when' clause covering the skill's full surface. Only slight room to improve by adding a few more natural synonyms (file extensions, 'Airflow pipeline') to the trigger list.

DimensionReasoningScore

Specificity

"Define reusable Airflow task group templates with Pydantic validation and compose DAGs from YAML" plus the when-clause's concrete capabilities (declaring shared variables, per-environment profiles, sharing templates as an installable package) lists multiple specific actions with comprehensive coverage. It is third person and free of fluff — clearly the top anchor, not 4, since coverage is broad without generic padding.

5 / 5

Completeness

It explicitly answers both: what ("Define reusable Airflow task group templates with Pydantic validation and compose DAGs from YAML") and when ("Use when creating blueprint templates, composing DAGs from YAML, ... or enabling no-code DAG authoring for non-engineers") with concrete trigger phrases. This matches the anchor-5 example pattern exactly.

5 / 5

Trigger Term Quality

Good natural-phrase coverage — "blueprint templates", "composing DAGs from YAML", "shared variables", "per-environment profiles", "validating configurations", "no-code DAG authoring" — mirroring what users would say. A few natural terms are missing (e.g., "Airflow pipeline", the `.dag.yaml` file extension, "trigger with params"), so it falls just short of the comprehensive-with-synonyms anchor 5.

4 / 5

Distinctiveness Conflict Risk

A clear niche — composing Airflow DAGs from validated YAML/blueprint templates — with distinctive triggers (Pydantic validation, task group templates, profiles, installable blueprint packages) that other skills wouldn't claim. Overlap with adjacent Airflow skills is minimal and the body even disambiguates via cross-references, so it fits the 'clear niche with minimal conflict risk' anchor rather than 4.

5 / 5

Total

19

/

20

Passed

Validation

93%

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

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (727 lines); consider splitting into references/ and linking

Warning

Total

15

/

16

Passed

Repository

astronomer/agents

Path

skills/blueprint/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.