Content
100%Weight 40%Scale 1-5Reviews 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.
| Dimension | Reasoning | Score |
|---|---|---|
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 |