CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

gcp-dataflow

Provides guidance for writing, packaging and executing Apache Beam pipelines on GCP using Cloud Dataflow. Use when: - Creating an Apache Beam Dataflow pipeline. - Creating a Google Flex Template.

Quality

82%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

78%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 lean, highly actionable skill body: directive-first writing, concrete gcloud commands and filter strings, and a well-sequenced diagnostics workflow with a structured output template. The significant defect is progressive disclosure: both files the body depends on for its deepest detail are missing from the bundle, leaving broken references, and a few steps (REST endpoints, cloudbuild.yaml template, example launch command) stop short of executable.

Suggestions

Ship the referenced bundle files (resources/python_flex_template_reference.md and resources/dataflow_diagnostics_reference.md) or inline their essential content - currently both links are dead ends.

Add a minimal example launch command and a cloudbuild.yaml skeleton so the Flex Template build/launch flow is copy-paste ready.

Specify the actual Dataflow/Monitoring REST API endpoints (or gcloud equivalents) in the diagnostics workflow instead of 'Use Dataflow REST API', and add a post-launch status check step.

DimensionReasoningScore

Conciseness

The body is almost entirely terse directives ("Do NOT propose to use the Shadow plugin... unless the user explicitly requests a Fat Jar", "scan the pipeline project directory for... requirements.txt") with zero teaching of concepts Claude already knows. Rationale sentences ("Flex Templates offer a hermetic and reproducible launch environment") directly justify MUST directives rather than pad, fitting the lean/every-token-earns-its-place anchor; it does not exhibit the minor trimmable over-explanation of the 4 anchor.

5 / 5

Actionability

Concrete, executable specifics abound: "gcloud config get-value project", "gcloud dataflow jobs describe JOB_ID --full --format=\"json(pipelineDescription.executionPipelineStage)\"", exact filter strings ("resource.labels.step_id=...", "metric.labels.ptransform=..."), and named options (--requirements_file, --setup_file, --sdk_container_image). Below 5 because several steps remain high-level ("Use Dataflow REST API", "Use Monitoring REST API" without endpoints, "provide cloudbuild.yaml" without a template, no example launch command); above 3 because the guidance is executable, not pseudocode.

4 / 5

Workflow Clarity

The diagnostics section gives a clear 5-step numbered workflow (Understand User Request -> Transform Name Mapping -> Query Telemetry -> Analysis -> Output) with an explicit 7-part output template, and checkpoints exist ("Confirm the launch command with the user", "Confirm the values with the user before proceeding"). Below 5 because there is no post-launch verification or error-recovery loop (e.g. polling job status, what to do when a launch fails); above 3 because checkpoints are explicit rather than missing. The destructive/batch cap does not apply: building images and launching jobs are not destructive file/document/database operations.

4 / 5

Progressive Disclosure

The body defers detail to two clearly signaled, one-level-deep references ([python_flex_template_reference.md](resources/python_flex_template_reference.md), [dataflow_diagnostics_reference.md](resources/dataflow_diagnostics_reference.md)) and the SKILL.md itself is a well-organized overview. However, neither referenced file exists in the bundle (no resources/, references/, scripts/, or assets/ directories), so the deferred content - the Single Docker Image Configuration details and the diagnostics query patterns - is unreachable, which is a bigger defect than the 'minor organization gaps' of the 4 anchor.

3 / 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 strong, focused description: third-person voice, concrete actions, and an explicit 'Use when' clause with two real triggers. Its main weakness is that the what/when coverage stops at pipeline creation and omits the launching and diagnostics capabilities that make up half the skill body.

Suggestions

Extend the 'Use when' list with the other scenarios the skill covers, e.g. 'Launching a pipeline with DataflowRunner' and 'Debugging or investigating performance of a running Dataflow job'.

Add natural trigger variations such as 'Beam SDK', 'Dataflow job', or 'Flex Template build' so users phrasing the need differently still match.

Mention the diagnostics capability (e.g. 'diagnose performance and failures of running jobs') so the description reflects the full scope of the body.

DimensionReasoningScore

Specificity

"writing, packaging and executing Apache Beam pipelines on GCP using Cloud Dataflow" lists several concrete actions on a named stack. It is below 5 because coverage has gaps: the skill body also covers launching with the Dataflow Runner and Diagnostics & Troubleshooting, which the description never mentions; it is above 3 because it goes beyond 1-2 generic actions.

4 / 5

Completeness

Both parts are explicit: what ("Provides guidance for writing, packaging and executing Apache Beam pipelines") and when ("Use when: - Creating an Apache Beam Dataflow pipeline. - Creating a Google Flex Template."). Below 5 because the when-clause covers only creation scenarios and omits the launching and performance/troubleshooting triggers the body explicitly handles; above 3 because the when is explicitly stated with concrete triggers, not implied.

4 / 5

Trigger Term Quality

Natural terms users would say are present: "Apache Beam", "Dataflow", "Flex Template", "pipeline", "GCP". Below 5 because common variations are missing (e.g. "Beam SDK", "Dataflow job", "streaming/batch pipeline", debugging phrases like "pipeline is slow"); above 3 because the included keywords are the phrases practitioners actually use.

4 / 5

Distinctiveness Conflict Risk

"Apache Beam pipelines on GCP using Cloud Dataflow" carves out a clear niche with distinct triggers ("Dataflow", "Flex Template"); no plausible overlap with generic cloud, coding, or document skills, matching the minimal-conflict anchor.

5 / 5

Total

17

/

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

relative_links

Relative link issues: 2 missing

Warning

Total

15

/

16

Passed

Repository

saski/arnesto

Path

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