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.
The body is a highly actionable, well-organized CLI hub: concrete commands, correct-vs-incorrect contrasts, and explicit STOP checkpoints on the setup path. Its weaknesses are moderate duplication (repeated sandbox caveats and reference links) and a progressive-disclosure structure whose referenced files are absent from the bundle, leaving the routing to nonexistent material.
Suggestions
Ship the three referenced files (databricks-cli-install.md, databricks-cli-auth.md, manual-data-exploration.md) in the bundle — the body delegates critical setup and exploration steps to them, so their absence breaks the skill's routing.
Merge the two overlapping sandbox/blocked-install bullets in Prerequisites into one caveat, and remove the redundant 'Reference Guides' section (its links already appear in context) plus the duplicate manual-data-exploration.md mentions.
Promote the bundle commands into a short ordered workflow (init → validate → deploy → run) with an explicit 'validate passes before deploy' checkpoint, mirroring the floor-check pattern used for CLI installation.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with executable commands and assumes Claude's competence (e.g., the Claude Code shell-session note and the 'Names are literal' rule teach non-obvious facts without padding), matching 'Efficient; minor instances of over-explanation that could be trimmed'. Not a 5 because of real duplication: the sandboxed-environment caveat appears twice ('In sandboxed environments (Cursor IDE, containers)...' and 'Exception: If CLI installation is blocked (sandboxed containers...)'), and manual-data-exploration.md is linked three times (Data Exploration, Required Reading, Reference Guides) with the Reference Guides section repeating links already given inline. | 4 / 5 |
Actionability | Every section gives copy-paste-ready commands: `databricks auth profiles`, `databricks experimental aitools tools query "SELECT * FROM table LIMIT 10"`, `databricks tables get <CATALOG>.<SCHEMA>.<TABLE>`, and the Quick Reference even contrasts working vs. failing invocations ('✅ CORRECT: positional args' vs. '❌ WRONG: these flags/commands DON'T EXIST'). This matches 'Fully executable; copy-paste ready code or commands; specific examples cover the common cases'. | 5 / 5 |
Workflow Clarity | The setup workflow has explicit checkpoints and feedback loops ('Run the floor check... If it reports UPGRADE or INSTALL: STOP', 'Authenticated: databricks auth profiles — If not: see CLI Authentication') and profile selection is a numbered checklist, matching 'Clear sequence with most checkpoints present; minor validation gaps'. Not a 5 because other multi-step flows (e.g., bundle deploy) are presented only as a flat command list with no validate-then-deploy sequence or post-deploy verification, and not a 3 because the critical path does have explicit STOP/verify directives. | 4 / 5 |
Progressive Disclosure | References are one level deep, clearly signaled as links, and reinforced by a task-based routing table ('Required Reading by Task'), which is good structure — but scored against the actual bundle, none of the three referenced files (databricks-cli-install.md, databricks-cli-auth.md, manual-data-exploration.md) exist in the bundle (only assets/databricks.png and databricks.svg are present). The disclosure chain is therefore broken: the body repeatedly delegates critical setup steps to files that are missing, so navigation fails exactly where the skill says 'READ BEFORE proceeding'. This lands at 'Some structure but could be better organized' in effect — not a 4, since the missing targets are more than a minor organization gap. | 3 / 5 |
Total | 16 / 20 Passed |