Content
92%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A concise, highly actionable SQL reference with executable examples and a validation guideline. Its main weakness is progressive disclosure: it references five detail files that are not present in the bundle.
Suggestions
Add the missing referenced files (sql-scripting.md, materialized-views-pipes.md, geospatial-collations.md, ai-functions.md, best-practices.md) under references/ so the one-level-deep navigation resolves.
If those detail files are intentionally absent, remove the reference links and inline the minimal syntax needed, or note that the body is self-contained.
Consider moving the longer code blocks (e.g. full stored-procedure and geospatial examples) into the referenced detail files to keep SKILL.md as a tighter overview.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean: a quick-reference table, concise executable SQL examples, and brief guideline bullets, with no padding explaining concepts Claude already knows such as what SQL or Databricks is. | 3 / 3 |
Actionability | Every pattern is shown as complete, copy-paste-ready SQL (e.g. 'CREATE OR REPLACE PROCEDURE...', 'WITH RECURSIVE...', 'SELECT * FROM read_files(...)') with concrete syntax and options rather than pseudocode. | 3 / 3 |
Workflow Clarity | As a single-purpose SQL reference, each action is unambiguous and the Key Guidelines include an explicit validation checkpoint ('Use MCP tools (execute_sql, execute_sql_multi) to test and validate all SQL before deploying'), which the rubric permits to score 3 for simple skills. | 3 / 3 |
Progressive Disclosure | The body signals one-level-deep references in a well-organized table with clear 'When to Read' guidance, but the referenced files (sql-scripting.md, materialized-views-pipes.md, geospatial-collations.md, ai-functions.md, best-practices.md) do not exist in any bundle directory, so navigation points to missing files. | 2 / 3 |
Total | 11 / 12 Passed |