CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

tracing-upstream-lineage

Trace upstream data lineage. Use when the user asks where data comes from, what feeds a table, upstream dependencies, data sources, or needs to understand data origins.

64

Quality

81%

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

75%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 solid, well-sequenced investigation workflow with concrete Astro/Airflow CLI commands and clear output format guidance. Its weaknesses are modest: no explicit fallback loops for dead-end searches, and example report content that pads the token budget slightly.

Suggestions

Add brief fallback guidance for dead ends (e.g., 'If no DAG name matches the table, grep DAG source code for the table name or check the Astro Lineage tab'), which would add an explicit feedback loop and raise workflow clarity.

Trim the illustrative lineage trees and fabricated report rows to schema-only examples (headers plus placeholder rows) to tighten the token budget.

Consider moving the full Output report format section into a references/ file if the skill grows, keeping SKILL.md as a lean overview.

DimensionReasoningScore

Conciseness

The body is efficient — it assumes Airflow knowledge, gives commands without library tutorials, and uses compact lists ('S3Operator -> S3 bucket source'). Minor trimming is possible: the two large illustrative ASCII lineage trees and the fabricated example report rows (freshness '2h ago', owner 'data-team') are example filler that could be shortened, so it fits 'efficient; minor instances of over-explanation that could be trimmed' rather than the fully lean score 5.

4 / 5

Actionability

Concrete, copy-paste-ready commands appear throughout: 'af dags list', 'af dags source <dag_id>', 'af tasks list <dag_id>', 'af dags stats', plus specific search patterns ('load_customers -> customers table') and column-transformation examples. It falls short of score 5 only because key steps rely on hints ('Look for INSERT, MERGE...') rather than complete worked examples of interpreting command output, and the recursion in Step 4 is described but not given as a concrete procedure.

4 / 5

Workflow Clarity

A clear five-step sequence (identify target type -> find producing DAG -> trace sources -> build chain -> check source health) with a health-check step serving as validation. It does not reach score 5 because there are no explicit error-recovery loops (e.g., what to do when no DAG name matches the table or a source cannot be traced), leaving feedback checkpoints implicit.

4 / 5

Progressive Disclosure

No bundle files exist, and the ~135-line body is organized into well-labeled sections with cross-links to sibling skills clearly signaled under 'Related Skills'. Structure is good, matching 'good structure; most content is appropriately placed; minor organization gaps' — the Output report format and column-lineage sections are borderline candidates for separate reference files if the skill grows, keeping it below score 5.

4 / 5

Total

16

/

20

Passed

Description

78%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 well-constructed description with an explicit 'Use when...' clause and natural trigger phrases covering the main ways a user would ask about data origins. Its main limitation is that the 'what' is a single action — trace lineage — without naming the supporting capabilities the skill body actually contains.

DimensionReasoningScore

Specificity

The description names the domain ('Trace upstream data lineage') but lists only that single action — no additional concrete capabilities (e.g., tracing columns, checking source health) are stated. This matches the anchor 'names domain and 1-2 concrete actions, but not comprehensive'; it is above score 2 because the action is concrete, and below score 4 because several specific actions are not enumerated.

3 / 5

Completeness

It explicitly answers both: 'what' ('Trace upstream data lineage') and 'when' ('Use when the user asks where data comes from, what feeds a table, upstream dependencies, data sources, or needs to understand data origins') with concrete trigger phrases. This directly matches the score-5 anchor.

5 / 5

Trigger Term Quality

Natural user phrases are well covered: 'where data comes from', 'what feeds a table', 'upstream dependencies', 'data sources', 'data origins'. It falls just short of score 5's comprehensive synonym coverage — common variations like 'lineage', 'impact of sources', or specific artifact terms (table/DAG mentions) are not all present as distinct triggers.

4 / 5

Distinctiveness Conflict Risk

'Upstream' clearly carves a niche that distinguishes it from a downstream-impact skill, and triggers like 'what feeds a table' are specific. Minor overlap risk remains with related data-skill territory (e.g., generic 'data sources' phrasing could also match ingestion or freshness skills), so it fits 'mostly distinct; minor overlap risk' rather than the fully conflict-free score 5.

4 / 5

Total

16

/

20

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.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

astronomer/agents

Path

skills/tracing-upstream-lineage/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.