CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

gcp-composer-troubleshooting

Provides expert guidance for troubleshooting Cloud Composer (Apache Airflow) and Orchestration pipelines. Use this skill when the user asks to generate Root Cause Analysis (RCA), troubleshoot or fix a failed pipeline, DAG in Composer environment and generate RCA report.

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-composer-troubleshooting/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

63%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 well-structured, largely actionable troubleshooting playbook with a clear five-step RCA process, concrete gcloud commands, and useful scenario branching. Its main weaknesses are redundancy (the read-only rule stated three times), malformed command formatting, and a monolithic layout where the pipeline templates and command reference belong in separate on-demand files.

Suggestions

Deduplicate the code-modification constraint into one constraint entry and remove the persona padding to tighten the body.

Reformat 'Example Gcloud commands' as fenced code blocks with one command per block so they are copy-paste ready, keeping flags like --locations as a one-line note.

Move the declarative pipeline YAML templates into a references/pipelines.md file (and optionally the gcloud command catalog into references/gcloud-commands.md), keeping SKILL.md as an overview with clearly signaled one-level-deep links.

DimensionReasoningScore

Conciseness

Mostly efficient procedural instructions, but there is noticeable slack: the no-code-modification rule is stated three times ('Do not modify code at this stage', 'Read-Only First: Do NOT attempt to fix the code immediately', 'Do not modify the code. Just analyze...'), the persona section ('You are methodical, evidence-based, and safety-conscious') pads without adding instructions, and the 'Example Gcloud commands' bullets have prose ('Always use --locations flag') fused into command text. Not score 4 because the repetition and formatting clutter go beyond 'minor instances'; not score 2 because the bulk is actionable instruction rather than explanation of concepts Claude already knows.

3 / 5

Actionability

Concrete, executable material is present: exact gcloud commands ('gcloud composer environments list-dags --locations=us-central1', 'gcloud storage cp gs://bucket-name/dags/dag-id.py .'), specific log filters ('resource.type="cloud_composer_environment"', 'severity="ERROR"'), a worked example workflow with a sample RCA finding, and full declarative pipeline YAML templates. Not score 5 because the gcloud command section is malformed — commands wrap across lines and mix commentary into the command text, so they are not cleanly copy-paste ready.

4 / 5

Workflow Clarity

A strict five-step sequence (Context Gathering → Log Analysis → Code Retrieval → RCA → Proposal & Fix) with most checkpoints present: asking for DAG ID when the error is vague, the Code Consistency Check with Match/Mismatch branches, and user confirmation before syncing or overwriting. Not score 5 because there is no explicit validation of the analysis itself (e.g., re-checking the pinpointed line against a second log entry) and the fix-application path has no post-fix verification step; comfortably above score 3 since decision checkpoints are explicit throughout.

4 / 5

Progressive Disclosure

The body has clear section headers and navigable organization, but it is a single ~230-line file with no references or bundle files: the ~90 lines of declarative pipeline templates and the gcloud command catalog are inlined content that would fit better in separate reference files loaded on demand. Not score 2 because structure is genuinely good (headers, scenarios, examples) rather than a header-less wall of text; not score 4 because nothing is split out and no navigation to deeper material exists.

3 / 5

Total

14

/

20

Passed

Description

73%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 solid description with an explicit 'Use when' clause, concrete trigger terms, and a well-defined niche. Its weaknesses are limited action coverage (only RCA generation and troubleshoot/fix are named), a redundant repeated phrase, and awkward grammar in the trigger clause that slightly muddies the 'when' guidance.

Suggestions

Consolidate the repeated 'generate RCA' phrases and list the full action set concisely, e.g. '...analyze failed-task logs, compare remote DAG code with local code, pinpoint root causes, and generate RCA reports'.

Clean up the trigger clause grammar: 'Use when the user mentions a failed DAG, pipeline failure, task failure, or Airflow/Composer errors, or asks for a Root Cause Analysis (RCA) report'.

DimensionReasoningScore

Specificity

The description names the domain ('troubleshooting Cloud Composer (Apache Airflow) and Orchestration pipelines') and one or two concrete actions ('generate Root Cause Analysis (RCA)', 'troubleshoot or fix a failed pipeline'), but coverage is not comprehensive — log analysis, remote code retrieval, and declarative pipeline generation are never mentioned, and 'Provides expert guidance' is generic padding. Not score 4 because fewer than 'several' distinct specific actions are listed and 'generate RCA' is stated twice rather than adding new capability; not score 2 because the actions named are concrete rather than minimal/generic.

3 / 5

Completeness

Both parts are explicitly present: 'what' ('Provides expert guidance for troubleshooting Cloud Composer (Apache Airflow) and Orchestration pipelines') and an explicit 'when' clause ('Use this skill when the user asks to generate Root Cause Analysis (RCA), troubleshoot or fix a failed pipeline, DAG in Composer environment'). Not score 5 because the 'when' clause is garbled ('failed pipeline, DAG in Composer environment and generate RCA report'), making the trigger guidance less clear than the rubric's exemplar; well above score 3 since the 'Use when' clause is explicit rather than weakly implied.

4 / 5

Trigger Term Quality

Natural trigger phrases users would say are present: 'Root Cause Analysis (RCA)', 'troubleshoot or fix a failed pipeline', 'DAG', 'Composer environment'. Not score 5 because common variations like 'Airflow' (only appears once in parentheses), 'task failure', 'pipeline error', or 'fix my DAG' phrasings are missing; clearly above score 3 since multiple natural terms beyond the bare domain name are covered.

4 / 5

Distinctiveness Conflict Risk

It occupies a clear niche (Cloud Composer / Apache Airflow pipeline troubleshooting and RCA) with distinct triggers ('Cloud Composer', 'Airflow', 'DAG', 'RCA', 'failed pipeline'), so it is unlikely to fire for unrelated skills. Score 4 would apply if there were notable overlap with closely related skills, but generic troubleshooting requests would not naturally match this description's specific domain terms.

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

saski/arnesto

Path

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