Content
81%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.
An unusually actionable, well-gated operational skill: concrete commands, explicit STOP-gated validation, and real error-recovery guidance. Its critical defect is that the progressive-disclosure layer is broken — the three reference files it repeatedly and correctly points to are missing from the bundle, so the prerequisite floor-check and auth procedures cannot actually be followed.
Suggestions
Ship the referenced bundle files databricks-cli-install.md, databricks-cli-auth.md, and manual-data-exploration.md (or remove the links); the 'Run the floor check in CLI Installation' gate currently points to nothing.
De-duplicate: state the databricks-data-discovery routing once and drop the 'Reference Guides' section that repeats the same three links already given in 'Required Reading by Task'.
Merge the two sandbox/blocked-install caveats (Cursor/containers note and the Exception bullet) into a single fallback procedure.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Largely lean and command-first with almost no explanation of concepts Claude already knows, but there is trimming to do: the databricks-data-discovery routing is stated twice (Product Skills and Data Exploration sections), the three reference files are listed in both 'Required Reading by Task' and 'Reference Guides', and the sandbox-install caveat appears twice (Prerequisites bullet 4 and the Exception bullet). Not 5 because of this repeated material; not 3 because the padding is duplication rather than over-explanation. | 4 / 5 |
Actionability | Fully executable throughout: copy-paste CLI commands with placeholders, correct/incorrect command contrasts ('# ❌ WRONG: these flags/commands DON'T EXIST'), the shell-session profile gotcha shown as WORKS/DOES NOT WORK examples, and an error-to-solution troubleshooting table. Covers the common cases concretely. | 5 / 5 |
Workflow Clarity | The setup workflow is clearly sequenced with explicit validation checkpoints and feedback loops: run the CLI floor check, 'If it reports UPGRADE or INSTALL: STOP and follow that reference file', verify auth via 'databricks auth profiles', then a numbered profile-selection procedure with a hard 'NEVER auto-select' rule. Error recovery is covered by the troubleshooting table and re-auth path. Not 4 because checkpoints are explicit and gate progression, not merely implied. | 5 / 5 |
Progressive Disclosure | The body is structured as a proper overview with one-level-deep, clearly signaled references ([CLI Installation](databricks-cli-install.md), [CLI Authentication](databricks-cli-auth.md), [Manual Data Exploration](manual-data-exploration.md)) — but none of these files exist in the bundle (no references/, scripts/, or assets .md files beyond two images), so the entire detail layer the skill depends on (the CLI floor check itself lives in databricks-cli-install.md) is unreachable. Scored against the actual bundle structure: navigation is clearly signaled but broken, which is below the anchor-3 'references present but not clearly signaled' middle and closer to the anchor-2 failure of a usable reference structure. | 2 / 5 |
Total | 16 / 20 Passed |