CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

troubleshooting-astro-deployments

Troubleshoot Astronomer production deployments with Astro CLI. Use when investigating deployment issues, viewing production logs, analyzing failures, or managing deployment environment variables.

64

Quality

81%

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

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

Highly actionable content with concrete, executable Astro CLI commands and a well-signposted structure. The main gaps are repeated command blocks across overlapping sections that could be consolidated, and a lack of verification steps around the destructive variable update/delete operations.

Suggestions

Add validation around destructive variable operations: show listing variables after create/update ('astro deployment variable list --deployment-id <DEPLOYMENT_ID> --key <KEY>') to confirm the change, and confirm the key before delete.

Consolidate the repeated 'astro deployment inspect' / 'logs --error' blocks: the Complete Investigation Workflow and Common Investigation Patterns restate commands from Quick Health Check — have pattern sections reference the workflow steps rather than re-listing commands.

Move the full environment-variable CRUD command reference (or the log-flag catalog) into a references/ file with a clearly signaled link from SKILL.md to keep the main file a lean troubleshooting overview.

DimensionReasoningScore

Conciseness

The body is mostly efficient — it is command-driven with no explanations of concepts Claude already knows — but the same commands recur across sections ('astro deployment inspect', 'logs --error -c 50', 'variable list --deployment-id' each appear 4+ times across Quick Health Check, the investigation workflow, and Common Investigation Patterns), and the 'Best Practices' section restates guidance already given (e.g., 'Log count default is 500' repeats line 34's note). This matches 'mostly efficient but includes some unnecessary explanation or could be tightened' rather than the noticeably padded 2 anchor.

3 / 5

Actionability

Every section gives copy-paste-ready, executable commands with consistent placeholders ('astro deployment logs <DEPLOYMENT_ID> --error -c 50', 'astro deployment variable create ... --secret'), plus a symptom-to-command quick reference table and concrete 'Look for:' field names from inspect output (resource_quota_cpu, max_worker_count). This matches the fully executable anchor covering common cases.

5 / 5

Workflow Clarity

The five-step investigation workflow is clearly sequenced with per-step 'Look for:' checkpoints, but the skill includes destructive operations (variable update/delete) with no verification or confirmation steps — e.g., 'astro deployment variable delete ... --key OLD_KEY' has no post-check — which caps workflow clarity at 3 per the destructive-operations guideline. Without that cap it would merit 4-5, but the missing feedback loop for destructive changes is disqualifying.

3 / 5

Progressive Disclosure

No bundle files exist and the ~320-line body is well organized with clear section headers, a quick-start, a patterns section, and a quick-reference table — matching 'good structure; most content is appropriately placed'. It is not a 5 because reference-style material (the full environment-variable CRUD command reference and the log-flag catalog) is inlined in SKILL.md where a one-level-deep reference file would keep the overview leaner.

4 / 5

Total

15

/

20

Passed

Description

83%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 description: third-person, concise, with an explicit 'Use when...' clause covering concrete triggers. The only notable weakness is slight overlap with sibling Astro management skills via the environment-variable management trigger, and a few missing natural synonyms.

DimensionReasoningScore

Specificity

The description names the domain ('Astronomer production deployments with Astro CLI') and lists several concrete activities ('investigating deployment issues, viewing production logs, analyzing failures, or managing deployment environment variables'), so it matches the 'several specific actions; minor gaps in coverage' anchor. It is not a 5 because the core 'what' is a single umbrella action ('Troubleshoot ... deployments') and coverage of capabilities like inspecting deployment configuration is only implied.

4 / 5

Completeness

It explicitly answers both questions: the 'what' ('Troubleshoot Astronomer production deployments with Astro CLI') and a concrete 'when' ('Use when investigating deployment issues, viewing production logs, analyzing failures, or managing deployment environment variables'), matching the top anchor. It is not below 5 because both halves are explicit and trigger phrases are concrete rather than implied.

5 / 5

Trigger Term Quality

Natural phrases users would say are present: 'deployment issues', 'production logs', 'analyzing failures', 'environment variables', plus product terms 'Astronomer' and 'Astro CLI'. It is short of the 5 anchor because common synonyms and variations are missing (e.g., 'errors', 'debugging', 'env vars', 'Airflow').

4 / 5

Distinctiveness Conflict Risk

The niche is clear (production troubleshooting via Astro CLI) and mostly distinct, but 'managing deployment environment variables' overlaps with the sibling managing-astro-deployments skill referenced in the body, so minor overlap risk with a closely related skill remains — matching the 4 anchor rather than the minimal-conflict 5 anchor.

4 / 5

Total

17

/

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

astronomer/agents

Path

skills/troubleshooting-astro-deployments/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.