Content
82%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 highly actionable with concrete copy-paste commands and a clear routing workflow including a verification checkpoint. It is slightly verbose in its rationale/positioning sections, which keeps conciseness just below the top anchor.
Suggestions
Tighten the "Why prefer Genie for data questions" and "Relationship to the Genie One MCP" sections to the essential routing rationale — the naming-history footnote can collapse to one line.
Make the manual-fallback branch's sequence more explicit as a numbered checklist (verify availability → fall back to information_schema/discover-schema/tools query) to lift workflow_clarity toward 5.
Consider moving the extended flag reference (--raw, --warehouse-id, parallelism rules) into a short reference subsection or sibling file so the main flow stays lean.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient and assumes Claude's competence, but sections like "Why prefer Genie for data questions", "Relationship to the Genie One MCP", and the naming history add prose that could be trimmed — fitting the score-4 anchor rather than 5. | 4 / 5 |
Actionability | Copy-paste-ready commands ("databricks genie ask -s trips \"How many bookings were there last week?\"") cover session reuse, --include-sql, --output json with a sample payload, and the older-CLI fallback — fully executable and matching the score-5 anchor. | 5 / 5 |
Workflow Clarity | A clear routing decision tree precedes an explicit verification checkpoint ("first verify with databricks genie ask --help") before fallback, with minor validation gaps; the destructive-cap does not apply since discovery is read-only. | 4 / 5 |
Progressive Disclosure | Well-sectioned body (~136 lines) with clearly signaled one-level-deep links to the parent/sibling ("../databricks-core/manual-data-exploration.md") and no nested references, but it is over 50 lines so the simple-skill score-5 exception does not apply. | 4 / 5 |
Total | 17 / 20 Passed |