CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

prefect-cross-flow-to-orchestra

Use this skill when a Prefect flow triggers another deployment using run_deployment(), or when a flow is called as a subflow from a parent @flow. Triggers: any Prefect code with run_deployment(), await run_deployment(), or a @flow function called inside another @flow (subflow pattern).

Quality

78%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/migrate-to-orchestra/skills/prefect-cross-flow-to-orchestra/SKILL.md
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.

The body is a well-structured, highly actionable conversion guide with concrete mapping tables, executable YAML, a sequenced checklist, and strong gotchas. It scores solidly across dimensions, held back from 5s by repeated caveats, abbreviated example pipelines, and the absence of an explicit post-conversion verification step.

Suggestions

Add a final verification step to Conversion Steps, e.g., 'After applying trigger_events, open the downstream pipeline in the Orchestra UI and confirm the upstream pipeline appears as its trigger.'

Consolidate the TRIGGER_PIPELINE warning to one place (the Gotchas section) and reference it elsewhere instead of restating it three times.

Flesh out the abbreviated before/after example pipelines (replace 'pipeline: {}' stubs with minimal real task definitions) so the after-state is fully copy-paste ready.

DimensionReasoningScore

Conciseness

Efficient overall: no padding explaining what Prefect or orchestration is, and the mapping table and YAML blocks earn their tokens. Minor trimmable redundancy — the TRIGGER_PIPELINE caveat appears three times (Overview schema note, Conversion Steps, Gotchas) and the 'subflows become separate pipelines' point repeats in the table and Gotchas — which keeps it below the lean anchor 5 but above anchor 3.

4 / 5

Actionability

Concrete, executable guidance throughout: a construct-to-construct mapping table, copy-ready trigger_events YAML with run_inputs, an ordered conversion checklist, and a full before/after Python-to-YAML example. Minor gaps keep it from 5 — the example pipelines contain 'pipeline: {}' stubs and a '# (abbreviated)' block, so the after-state is not fully copy-paste ready.

4 / 5

Workflow Clarity

Conversion Steps is a clearly sequenced checklist with check-style steps ('confirm it has (or create) a corresponding Orchestra pipeline', 'verify against your instance's schema') covering sync, async, parameterized, sequential, and AND-logic cases. Not a 5: there is no explicit post-change validation step (e.g., confirm the downstream pipeline now triggers from the upstream), so checkpoints are mostly present with a minor gap.

4 / 5

Progressive Disclosure

No bundle files exist, and all ~150 lines are appropriately inline for a single conversion task: well-organized sections (Overview, Parameter Mapping, YAML Structure, Conversion Steps, Before/After, Gotchas, References) with clearly signaled external doc URLs and a one-level pointer to the sibling prefect-alerts-to-orchestra skill. Exceeds the under-50-line simple-skill case, and the before/after example could arguably live in a separate reference, so it fits anchor 4 rather than 5.

4 / 5

Total

16

/

20

Passed

Description

70%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 has excellent, explicit trigger coverage with concrete Prefect constructs, but it omits any statement of what the skill does (convert Prefect cross-flow patterns to Orchestra trigger_events-based pipelines). Adding a one-clause capability statement would raise completeness and specificity substantially.

Suggestions

Add a 'what' clause stating the skill's action, e.g., 'Converts Prefect run_deployment() and subflow patterns to Orchestra pipelines using trigger_events: on the downstream pipeline.'

Include a few more natural synonyms in the trigger list, such as 'child flow', 'trigger another flow', or 'fire-and-forget deployment', to catch phrasings users actually say.

Mention the target system (Orchestra) in the description so the skill is discoverable when a user asks about Orchestra pipeline triggering without naming Prefect constructs.

DimensionReasoningScore

Specificity

Quotes several concrete constructs — 'run_deployment()', 'await run_deployment()', 'a @flow function called inside another @flow' — matching the anchor for several specific items with minor gaps. Not a 5: it never states what the skill actually does with these patterns, so capability coverage is incomplete.

4 / 5

Completeness

The 'when' is fully explicit ('Use this skill when…', 'Triggers: any Prefect code with run_deployment()…'), but the 'what' is entirely absent — the description never says the skill converts these Prefect patterns to Orchestra pipelines via trigger_events. This sits between anchor 2 ('only when present without what') and anchor 4; the unusually explicit trigger guidance lifts it to the midpoint, but the missing what blocks 4.

3 / 5

Trigger Term Quality

Good keyword coverage with natural Prefect vocabulary ('run_deployment()', 'await run_deployment()', 'subflow', 'parent @flow') covering sync, async, and subflow variations. A few natural terms users might say are missing (e.g., 'child flow', 'trigger another flow'), so it falls short of the comprehensive anchor 5.

4 / 5

Distinctiveness Conflict Risk

A clear niche — Prefect cross-flow triggering and subflow patterns — with distinct trigger terms (run_deployment, subflow) that a user would naturally say. Minimal conflict risk; only slight adjacency to sibling Prefect-to-Orchestra skills, whose triggers (e.g., alerts/notifications) are clearly different.

5 / 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

orchestra-hq/orchestra-skills

Path

skills/migrate-to-orchestra/skills/prefect-cross-flow-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.