Content
78%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.
A highly actionable, well-sequenced CLI entry-point skill whose quick reference, error tables, and STOP-gated setup flow are exemplary. Its two real weaknesses are progressive disclosure (all three referenced detail files are missing from the bundle) and modest duplication in the data-discovery routing sections.
Suggestions
Ship the three referenced files (databricks-cli-install.md, databricks-cli-auth.md, manual-data-exploration.md) in the bundle, or remove the links — every detailed-guidance pointer in the body currently resolves to nothing.
Consolidate the duplicated databricks-data-discovery routing (explained in both the 'Product Skills' and 'Data Exploration' sections) into a single routing rule to save tokens.
Define or link the '/databricks-dabs' path invoked in the 'Required Reading by Task' table so the deploy route is followable.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is command-dense and imperative — quick-reference blocks, error tables, and CRITICAL warnings all earn their tokens. Minor over-explanation could be trimmed: the data-discovery routing is explained twice ("Product Skills" and "Data Exploration" sections), the reference guides are listed in both "Required Reading by Task" and "Reference Guides", and lines like "A CLI that is present but too old is not 'good enough' — it must be upgraded, not worked around" restate the adjacent STOP instruction. Not 5 due to this duplication; not 3 because the padding is minor relative to the volume of concrete guidance. | 4 / 5 |
Actionability | Fully executable throughout: complete commands with --profile flags ("databricks apps list --profile my-workspace"), explicit CORRECT vs. WRONG positional-argument examples with the failing variants crossed out, exact error strings mapped to fixes ("cannot configure default credentials" → "Use --profile flag or authenticate first"), an exact signup URL, and concrete env-var fallback (DATABRICKS_HOST/DATABRICKS_TOKEN). The harness-specific shell-session example (WORKS/DOES NOT WORK) is copy-paste ready. | 5 / 5 |
Workflow Clarity | Sequenced setup workflow with an explicit validation gate ("Run the floor check... If it reports UPGRADE or INSTALL: STOP"), numbered profile-selection steps with the NEVER-auto-select rule, and a troubleshooting table serving as an error-recovery feedback loop. Minor gaps: the deploy row routes to "/databricks-dabs" which is undefined here, and there is no explicit post-auth verification step. Not 5 because checkpoints are spread across sections rather than a unified flow and one route dangles; not 3 because validation checkpoints and error recovery are explicitly present. | 4 / 5 |
Progressive Disclosure | The SKILL.md itself is well structured as an overview with clearly signaled one-level references ([CLI Installation](databricks-cli-install.md), [CLI Authentication](databricks-cli-auth.md), [Manual Data Exploration](manual-data-exploration.md)) and a task→reading table. However, none of those three referenced files exist in the bundle (no references/ directory; the only bundle files are unreferenced assets databricks.png/databricks.svg), so every detailed-content pointer dangles and navigation dead-ends. Not 4 because the bundle structure doesn't back the reference scheme; not 2 because the body is genuinely well sectioned and references are prominently signaled, not buried or replaced by inlined bulk content. | 3 / 5 |
Total | 16 / 20 Passed |