CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

gcp-pipeline-orchestration

This skill helps the agent generate or update orchestration pipeline definitions for Google Cloud Composer to initialize orchestration pipeline or update the orchestration definition for orchestration of various data pipelines, like dbt pipelines, notebooks, Spark jobs, Dataform, Python scripts or inline BigQuery SQL queries. This skill also helps deploy and trigger orchestration pipelines.

Quality

75%

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 ./.agents/skills/gcp-pipeline-orchestration/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

73%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 delivers a strongly sequenced, validated workflow with concrete executable gcloud commands and a well-signaled one-level-deep reference bundle. Its main weaknesses are token inefficiency from duplicated sections and filler sentences, plus a malformed fallback command that is not copy-paste executable.

Suggestions

Remove the duplicated "## How to use this skill" header (lines 25 and 47) and fold the intro bullets into the step sequence to eliminate redundant guidance.

Consolidate the deployment.yaml specification, which currently appears twice (the Step 2 field-by-field description and the "Declarative Pipeline Templates" section), into a single authoritative section or move it into the schema reference file.

Fix the mangled line continuations in the fallback trigger command so it renders as a multi-line copy-pasteable command, and add scripts/trigger/airflow_trigger.py to the reference routing table so the bundle script is discoverable.

DimensionReasoningScore

Conciseness

The body is mostly operational instructions with concrete commands, but it contains unnecessary padding: a duplicated "## How to use this skill" header (lines 25 and 47), filler sentences ("This skill is helpful to create or update configuration files to orchestrate data pipelines."), and the deployment.yaml structure specified twice (Step 2 field list and the "Declarative Pipeline Templates" section). It is above a 2 because the bulk of the content is actionable rather than explanatory of concepts Claude already knows.

3 / 5

Actionability

Provides concrete, mostly copy-paste-ready gcloud commands for every phase (init, dataproc/composer listing and describe, validate, deploy, trigger, list runs, pause/unpause) with placeholder-replacement comments, plus a YAML template and a fallback script path. It falls short of 5 because the fallback command's line continuations are mangled onto a single line ("python scripts/trigger/airflow_trigger.py \ --project <PROJECT_ID> --location <REGION> \...") making it not directly executable as written.

4 / 5

Workflow Clarity

A clearly sequenced 7-step workflow (assess/init → review schema → generate → validate → handle errors → deploy → trigger) with an explicitly REQUIRED validation step, an error-recovery feedback loop ("Edit the orchestration and deployment files to fix the specific issue... Re-run the validation command"), a poll-with-timeout readiness check (sleep 30, poll 15s up to 2 min), and a "Definition of done" checklist. This matches the anchor for clear sequence with explicit validation, feedback loops, and checklists.

5 / 5

Progressive Disclosure

The "Mandatory Reference Routing" table clearly signals the single one-level-deep reference (references/orchestration-pipelines-schema.md, which exists and delegates the large YAML schema appropriately), and the fallback script (scripts/trigger/airflow_trigger.py, which exists) is included. Minor gaps keep it below 5: the fallback script is buried in an IMPORTANT note instead of the routing table, the deployment.yaml spec is duplicated inline, and the duplicated top-level header slightly muddies navigation.

4 / 5

Total

16

/

20

Passed

Description

66%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 communicates a concrete, well-scoped capability set for Google Cloud Composer orchestration pipelines with good technology keyword coverage, but it lacks any explicit "Use when..." trigger guidance, which caps its completeness and weakens its discoverability. Redundant phrasing ("initialize orchestration pipeline or update the orchestration definition for orchestration of...") slightly dilutes an otherwise specific capability list.

Suggestions

Add an explicit 'Use when...' clause with concrete trigger phrases, e.g., "Use when the user asks to create, schedule, deploy, or trigger orchestration pipelines in Google Cloud Composer, or mentions orchestrating dbt, Dataform, Spark, or BigQuery pipelines."

Rewrite the repetitive middle clause ("to initialize orchestration pipeline or update the orchestration definition for orchestration of various data pipelines") into a crisp enumeration of distinct capabilities: generate, update, validate, deploy, and trigger orchestration pipeline definitions.

Include common user-facing synonyms such as "Airflow DAG", "pipeline scheduling", and "Composer environment" to improve natural trigger-term coverage.

DimensionReasoningScore

Specificity

The description lists several concrete actions ("generate or update orchestration pipeline definitions", "initialize orchestration pipeline", "deploy and trigger orchestration pipelines") and names specific technologies (dbt, Spark, Dataform, BigQuery). It falls short of a 5 because the phrasing is repetitive ("update the orchestration definition for orchestration of...") rather than crisply enumerating distinct capabilities, and validation is not mentioned.

4 / 5

Completeness

The "what" is clear (generate/update orchestration pipeline definitions for Cloud Composer; deploy and trigger pipelines), but there is no "Use when..." clause or equivalent explicit trigger guidance, which caps completeness at 3 per the judging guidelines. It is not a 2 because the "what" half is concrete and specific, and not a 4 because the "when" is entirely absent rather than merely weakly implied.

3 / 5

Trigger Term Quality

Good keyword coverage including natural terms users would say: "orchestration pipeline", "Google Cloud Composer", "dbt", "Spark jobs", "Dataform", "BigQuery SQL", "deploy and trigger". A few natural terms are missing (e.g., "Airflow", "DAG", "scheduling", "pipeline schedule"), keeping it below the comprehensive-synonyms anchor of 5.

4 / 5

Distinctiveness Conflict Risk

It occupies a clear niche (Cloud Composer orchestration pipelines) with distinct triggers, so it is mostly distinguishable from other skills. Minor overlap risk remains with dedicated dbt, BigQuery, or Python-scripting skills since those technology names appear as orchestration targets, keeping it below the minimal-conflict anchor of 5.

4 / 5

Total

15

/

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

referenced_paths_exist

Referenced path issues: 1 deeper-than-1-level

Warning

Total

15

/

16

Passed

Repository

saski/arnesto

Path

.agents/skills/gcp-pipeline-orchestration/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.