CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

diagnostics

Diagnose a crashed, hung, or erroring deployed Databricks App. Use when: (1) an app is crashed / UNAVAILABLE / 502s, (2) an app hangs or is unresponsive, (3) you need the stack trace behind a failure, (4) questions about reading app logs or the diagnostics env toggles.

Quality

96%

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

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

Exemplary diagnostic skill content: every section adds information Claude could not infer (platform-specific log routing, SSO CLI limitation, pod lockdown constraints), commands are copy-paste ready, and the symptom-to-cause mapping doubles as a clear decision key. Structure and length are appropriate for a single-file skill with no bundle overhead.

DimensionReasoningScore

Conciseness

The body is lean and fully operational — exact log signatures, an env-toggle table, and copy-paste commands with no padding or explanation of concepts Claude already knows; the one justificatory note ("Why not pyspy/gdb/strace? Apps pods are locked down") preempts a wrong alternative rather than over-explaining.

5 / 5

Actionability

Guidance is fully executable: `https://<app-url>/logz`, `databricks apps logs <app-name> --follow --profile <profile>`, the `jq '.app_status'` status check, an `app.yaml` env snippet, and `kill -USR1 <pid>`, covering SSO/non-SSO, Python/Node, and crash/hang cases.

5 / 5

Workflow Clarity

The sections sequence the investigation clearly (get logs, with explicit SSO vs CLI branching → match the symptom-to-cause signatures in "What to look for" → hang procedure with explicit prioritization "check that first"). Diagnosis is read-only, so the destructive/batch validation cap does not apply, and the single investigation path is unambiguous.

5 / 5

Progressive Disclosure

No bundle files exist (verified: no references/, scripts/, or assets/ directories) and none are needed at this scope; the single file has well-organized sections and its one external pointer (".scripts/agent-integration-tests/crash-examples/") is clearly signaled and one level deep.

5 / 5

Total

20

/

20

Passed

Description

90%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 with explicit what/when structure and highly natural symptom-based trigger terms. The only deduction is the second-person phrasing in trigger (3) ("you need the stack trace"), which the rubric penalizes on specificity; rewriting it in third person ("when the stack trace behind a failure is needed") would lift the score.

DimensionReasoningScore

Specificity

The description names the domain and several concrete capabilities ("Diagnose a crashed, hung, or erroring deployed Databricks App", stack traces, reading app logs, diagnostics env toggles), which sits at the 'several specific actions; minor gaps' anchor; however, the rubric's second-person penalty applies because trigger (3) uses "you need the stack trace behind a failure", reducing the score from 4 to 3.

3 / 5

Completeness

It explicitly answers both questions: "Diagnose a crashed, hung, or erroring deployed Databricks App" states the what, and "Use when: (1)…(4)" gives four concrete trigger conditions for the when. It clearly matches the anchor requiring explicit what AND when with concrete trigger phrases.

5 / 5

Trigger Term Quality

The triggers are the literal symptom phrases a user would echo ("crashed / UNAVAILABLE / 502s", "hangs or is unresponsive", "stack trace", "app logs") with synonym clusters covering both crash-like and hang-like states; no meaningful natural terms are missing for this domain.

5 / 5

Distinctiveness Conflict Risk

"deployed Databricks App" plus platform-specific triggers (UNAVAILABLE/502s, diagnostics env toggles) carve out a clear niche with minimal overlap risk against other skills; nothing generic remains that would fire the wrong skill.

5 / 5

Total

18

/

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

databricks/app-templates

Path

.claude/skills/diagnostics/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.