Content
100%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 skill body: decision logic, error recovery, and operational sequences are stated with exact commands and API names, versioned legacy content is quarantined in a migration section, and all detail is pushed to a verified, well-labeled one-level-deep reference bundle. Nothing in the body explains concepts Claude already knows, and every section either directs a decision or an action.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is telegraphic and lean throughout — a compact decision tree, error-message-to-fix mappings ('UNRESOLVED_COLUMN', 'Cannot create streaming table from batch query'), exact syntax fragments, and navigation tables, with zero explanation of concepts Claude already knows. The one piece of time-sensitive/versioned content (legacy DLT syntax) is properly isolated in a dedicated migration section, satisfying the anchor where every token earns its place. Not 4 because no section is padded or could be materially trimmed without losing guidance. | 5 / 5 |
Actionability | Concrete, executable guidance throughout: copy-paste CLI sequences ('databricks bundle validate', 'databricks bundle deploy -t dev', 'databricks pipelines start-update'), exact API mappings ('dlt.apply_changes(...)' → 'dp.create_auto_cdc_flow(...)'), exact syntax ('FROM STREAM(name)', '__END_AT IS NULL', 'dbfs:/Volumes/<catalog>/<schema>/<volume>/<path>'), and behavioral specifics like 'stored_as_scd_type is integer 2 for Type 2'. This matches the fully-executable anchor; per the scoring notes, the absence of a full inline pipeline example is not penalized because actual definitions are deliberately delegated to the language-basics references and all stated commands are runnable. | 5 / 5 |
Workflow Clarity | Multi-step processes are explicitly sequenced with validation checkpoints: 'Sequence: databricks bundle validate, databricks bundle deploy -t dev, databricks bundle run <pipeline_name> -t dev', a dry-run checkpoint ('--validate-only is a faster way to confirm the correctness'), poll-the-update-ID monitoring with cold-start guidance ('don't cancel it'), and the destructive full-refresh operation explicitly gated behind user confirmation. Error-recovery feedback exists via Common Traps mapping specific failure messages to fixes, matching the anchor for clear sequence with explicit validation and recovery loops. Not 4 because no meaningful checkpoint is missing. | 5 / 5 |
Progressive Disclosure | Verified against the actual bundle: all 33 reference paths cited in the body exist in references/ (including the anchored link temporary-view-sql.md#using-expectations-with-temporary-views), are one level deep, and are clearly signaled with per-feature descriptions and mandatory-reading companions. Sibling cross-links between references are targeted section pointers (e.g., auto-loader → options-csv.md), not buried nesting, and spot-checked files contain real content (e.g., options-csv.md's 34-row option table). This matches the anchor for a clear overview with well-signaled one-level-deep references and easy navigation. Not 4 because no inlined content obviously belongs in a separate file — the decision tree and migration table are the core always-needed logic. | 5 / 5 |
Total | 20 / 20 Passed |