CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

dynamo-troubleshoot

Diagnose failed or unhealthy Dynamo deployments. Use when pods, model-cache jobs, PVCs, workers, frontend/router health, endpoints, or benchmark jobs fail; use recipe-runner/router-starter before this for normal bring-up.

Quality

87%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Medium

Suggest reviewing before use

SKILL.md
Quality
Evals
Security

Quality

Content

88%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, highly actionable troubleshooting body: an explicit top-down diagnostic order with validation gates, copy-paste commands, an output contract, and detail correctly deferred to real bundle files. The main issues are token-level redundancy between Instructions, the run_script() block, and Examples, plus a dangling BENCHMARK.md reference.

Suggestions

Remove or correct the dangling 'BENCHMARK.md' reference (the file is not in the bundle), or drop the 'Benchmark' section from SKILL.md.

Trim duplication: the Examples section and the run_script() block repeat the exact commands already shown in '1. Collect A Read-Only Bundle' — keep one bash and one agent-protocol form.

Make the validation gate concrete by naming the readiness check per layer (e.g. 'rerun kubectl rollout status / the endpoint smoke test') instead of the generic 'rerun the relevant readiness check'.

DimensionReasoningScore

Conciseness

The body is lean — no concept explanations Claude already knows, tight tables for scripts and troubleshooting symptoms, and detail correctly pushed to the decision-tree reference. It misses a 5 because of redundancy: the Examples section repeats the Instructions' collection commands nearly verbatim, and the run_script() invocation block duplicates the same call shown again in Examples, plus a marginal 'Benchmark' CI note — all trimmable tokens.

4 / 5

Actionability

Commands are copy-paste ready with concrete flags ("python3 scripts/collect_dynamo_debug_bundle.py --namespace \"${NAMESPACE}\" --deployment-name <deployment-name>"), a script table documents every argument, examples cover the common cases (whole-namespace triage and single-deployment scoping), and the Output Contract and Troubleshooting tables give exact next steps (e.g. 'Inspect container logs; check nvidia.com/gpu allocatable on nodes'). Fully executable guidance.

5 / 5

Workflow Clarity

The 'Debug Top Down' section gives an explicit 8-step ordered sequence, and validation checkpoints are stated, not implied: "After each fix, rerun the relevant readiness check before moving deeper" and "benchmark job only after endpoint smoke test passes". The fix guidance is constrained to smallest reversible changes with post-fix re-verification, giving a genuine validate→fix→retry feedback loop. This skill is read-only, so the destructive-operation cap does not apply.

5 / 5

Progressive Disclosure

Good structure against the actual bundle: the body stays an overview, references/ and scripts/ both exist, and pointers are well-signaled ("Read references/failure-decision-tree.md for bucket-specific checks", a References section, and a script table). It is below a 5 because the body cites "BENCHMARK.md" which does not exist in the bundle (dangling navigation) and the duplicated run_script() protocol block adds noise rather than disclosure.

4 / 5

Total

18

/

20

Passed

Description

82%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 with an explicit, concrete 'Use when...' clause, good natural trigger keywords across Dynamo failure surfaces, and explicit boundary guidance against sibling skills. Its only real weakness is thin 'what' coverage — a single action verb with no mention of the debug-bundle collection or failure classification the skill performs.

Suggestions

Add one or two concrete capability statements after 'Diagnose failed or unhealthy Dynamo deployments', e.g. 'collects a read-only kubectl debug bundle and classifies the failure into cluster, storage, image, GPU, or router buckets'.

Include a couple of high-frequency failure symptoms users actually type (e.g. CrashLoopBackOff, ImagePullBackOff, model-download job stuck) as trigger synonyms.

DimensionReasoningScore

Specificity

The description names a clear domain ("failed or unhealthy Dynamo deployments") and one concrete action ("Diagnose"), but stops there — it never mentions what the skill actually does, such as collecting a read-only kubectl debug bundle or classifying failures into buckets. This matches the anchor 'Names domain and 1-2 concrete actions, but not comprehensive'; it is above a 2 because the domain and trigger objects are specific, not generic.

3 / 5

Completeness

Explicitly answers both: 'what' — "Diagnose failed or unhealthy Dynamo deployments" — and 'when' — "Use when pods, model-cache jobs, PVCs, workers, frontend/router health, endpoints, or benchmark jobs fail". The 'when' clause enumerates concrete trigger phrases, exactly matching the anchor for 5; it is not a 4 because the trigger guidance is fully explicit rather than partly implied.

5 / 5

Trigger Term Quality

Good keyword coverage of the failure surfaces a user would actually name: "pods, model-cache jobs, PVCs, workers, frontend/router health, endpoints, or benchmark jobs fail". It is below a 5 because common failure synonyms users say in practice (e.g. CrashLoopBackOff, ImagePullBackOff, PVC pending, model download stuck) are absent.

4 / 5

Distinctiveness Conflict Risk

The niche is tightly scoped to Dynamo deployment failures and it even includes boundary guidance ("use recipe-runner/router-starter before this for normal bring-up") that steers normal bring-up away from this skill. Minimal conflict risk; matches the anchor for 5.

5 / 5

Total

17

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

Total

14

/

16

Passed

Repository

NVIDIA/skills

Path

skills/dynamo-troubleshoot/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.