Content
96%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 exemplary reference-style skill body: executable examples, per-function deep links into three real reference files, a staged batch pipeline with error handling at every stage, and a practical troubleshooting table, all with essentially no token waste. The only blemishes are minor navigation gaps — cross-skill links that don't resolve within this bundle and two unexplained asset files.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean and dense throughout — a signature/prereq table, five tight SQL patterns, a staged pipeline, and a troubleshooting table, with zero padding; it assumes competence (no "what is an LLM/Databricks" intro) and every row and code block carries operational payload. Not 4 because the few orientation clauses ("operate on table columns as naturally as UPPER() or LENGTH()") are load-bearing mental-model info, not over-explanation; version numbers (DBR 17.3/18.2) are prerequisites, not time-conditional API guidance. | 5 / 5 |
Actionability | All examples are copy-paste-ready, executable Databricks SQL with real syntax — named arguments (map('version','2.0'), failOnError => false, responseFormat => ...), VARIANT colon-access (:response:product::STRING), variant_get + LATERAL VIEW explode, TABLE(SELECT ...) for ai_forecast — plus a working PySpark expr() one-liner and concrete fixes in the Common Issues table. Not 4 because the examples collectively cover the common cases (classify/extract/mask/similarity/forecast/RAG) with no pseudocode or placeholder gaps. | 5 / 5 |
Workflow Clarity | The document pipeline is explicitly staged (parse → classify → extract) with validation at each checkpoint — parse errors filtered (WHERE parsed:error_status IS NULL), per-row extract_error and ai_query errorMessage surfaced, and batch-error routing to a sidecar table instead of crashing — satisfying the batch-operation validation requirement. Not 4 because checkpoints are explicit at every stage and the Common Issues table provides an error-recovery map on top; the batch cap does not apply since validation is present throughout. | 5 / 5 |
Progressive Disclosure | Good structure: the Overview table deep-links each function to its anchor in the three real one-level-deep reference files, and an explicit Reference Files section describes each — but checked against the actual bundle, three referenced paths (../databricks-vector-search/SKILL.md, ../databricks-genie-agents/SKILL.md, ../databricks-model-serving/SKILL.md) do not resolve, and assets/databricks.png|svg are never referenced or explained anywhere. Not 5 because those dangling cross-bundle links and orphaned assets are exactly the 'minor organization gaps' of the anchor-4 example; not 3 because all in-bundle references exist, are one level deep, and are clearly signaled. | 4 / 5 |
Total | 19 / 20 Passed |