CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

dagster-connections-to-orchestra

Use this skill when converting Dagster code that references resources holding credentials (ConfigurableResource subclasses, EnvVar, integration resources like SnowflakeResource / S3Resource / DbtCliResource, or resources wired into Definitions) to Orchestra. Triggers: any Dagster resource that stores host/login/token/key, any EnvVar used for credentials, or environment-specific resource configuration. Must be read before finalising any Orchestra YAML that contains a connection: field.

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

82%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 content is a strong, actionable conversion reference: executable YAML and SDK examples, complete mapping tables, and a sequenced checklist with several built-in validation notes. The main improvement opportunities are trimming a handful of explanatory asides and splitting the lookup tables into a referenced file so SKILL.md reads more like an overview.

Suggestions

Move the four resource-mapping tables (~50 lines) into a references/resource-mapping.md file and reference it from a short 'How to map resource types' pointer, keeping SKILL.md as a lean overview.

Tighten the wordy asides (e.g., the connection-name retrieval paragraph and the 'This mirrors how Dagster swaps resources' sentence) to direct instructions.

Add an explicit validate-and-recover step to the setup checklist (e.g., after creating a connection, verify it by listing connections and confirming the descriptive_name_NNNNN id and credential-store read succeeded before replacing placeholders).

DimensionReasoningScore

Conciseness

The body is dense with Orchestra-specific, non-obvious facts (5-digit suffix semantics, the <INTEGRATION>__<CONNECTION_ID>__<FIELD> naming scheme, credential-store read behavior) and assumes Dagster/YAML knowledge, but a few passages could be trimmed ("Read it back rather than asking someone to find it: connections are managed through ... as well as the UI", "This mirrors how Dagster swaps resources per deployment/environment"). It is efficient with minor over-explanation, matching anchor 4 rather than 5 where every token would earn its place.

4 / 5

Actionability

Guidance is copy-paste ready: complete YAML snippets (connection: my_snowflake_12345, ${{ ENV.SNOWFLAKE_CONN }}, inputs: blocks), full resource-to-connection mapping tables with key fields, an exact SDK call (orchestra.get_linked_connection("snowflake", connection_id="prod_12345")), a profiles.yml env_var snippet, and a concrete setup checklist. Not a 4 because no common case lacks executable detail; connection creation via API is delegated to a documented reference rather than left vague.

5 / 5

Workflow Clarity

The "Connection Setup Checklist" gives a clear sequenced process and validation checkpoints appear inline ("Orchestra reads the secret when the connection is saved and rejects it if it can't be read or its keys don't match", "Check a variable exists rather than assuming it"), but there is no explicit validate-then-fix-then-retry loop for the overall migration. This matches anchor 4 (most checkpoints present, minor validation gaps) rather than 5 (explicit feedback loops).

4 / 5

Progressive Disclosure

With no bundle files present, the single-file skill is well organized: clear section headers, scoped tables, a setup checklist, and a clearly listed References section of external docs. It falls short of anchor 5 because the ~211-line body carries large lookup tables (the resource-type mapping section) that would naturally split into a one-level-deep reference file in a progressively disclosed bundle.

4 / 5

Total

17

/

20

Passed

Description

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

The description is a strong example: it explicitly states what it does and when to use it, with concrete trigger phrases and named Dagster constructs that make it highly specific and largely conflict-free. Its only limitation is that it describes one conversion action rather than a breadth of capabilities, which caps specificity slightly.

DimensionReasoningScore

Specificity

The description names the domain ("converting Dagster code that references resources holding credentials ... to Orchestra") and enumerates concrete entities ("ConfigurableResource subclasses, EnvVar, integration resources like SnowflakeResource / S3Resource / DbtCliResource, or resources wired into Definitions"), but the action set is a single conversion task rather than several distinct actions, so it sits between the 3 and 5 anchors.

4 / 5

Completeness

Both what ("converting Dagster code that references resources holding credentials ... to Orchestra") and when ("Use this skill when ... Triggers: any Dagster resource that stores host/login/token/key, any EnvVar used for credentials, or environment-specific resource configuration") are explicitly stated with concrete trigger phrases, matching the anchor-5 example structure. A 4 would require the when-clause to be less explicit, which it is not.

5 / 5

Trigger Term Quality

It comprehensively covers the natural terms a user doing this migration would say — "Dagster resource that stores host/login/token/key", "EnvVar used for credentials", "environment-specific resource configuration", "connection: field" — including synonyms for the credential shapes (host/login/token/key). Not below 5 because no common phrasing in this niche is missing; not applicable above since 5 is the maximum.

5 / 5

Distinctiveness Conflict Risk

It carves a clear niche — Dagster-to-Orchestra credential/connection migration — with distinct triggers (credentialed resources, EnvVar for credentials, connection: fields in Orchestra YAML) that no generic or sibling skill would naturally claim. Not a 4 because the trigger scoping leaves no meaningful overlap with adjacent conversion skills.

5 / 5

Total

19

/

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

orchestra-hq/orchestra-skills

Path

skills/migrate-to-orchestra/skills/dagster-connections-to-orchestra/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.