Content
67%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.
A well-structured, highly actionable skill body with executable commands and complete YAML examples throughout. The main costs are token efficiency (duplicated install instructions and a definitional intro) and the absence of error-recovery guidance in the deployment workflow.
Suggestions
Remove the CLI installation prerequisites from the inline CLAUDE.md template (or move the whole template to a references/ file) — the parent databricks-core skill already covers CLI setup, cutting a large duplicated block.
Delete the opening definitional sentence ('Lakeflow Jobs are scheduled workflows that run notebooks...') — Claude already knows this and the parent skill provides context.
Add a short error-recovery loop to the Development Workflow (e.g. 'If validate fails, fix the reported resource errors and re-validate before deploying') to raise workflow clarity.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly lean code and YAML, but includes unnecessary material: the one-line definition of what Lakeflow Jobs are (knowledge Claude already has), and a full CLI-installation prerequisites block embedded in the CLAUDE.md template that duplicates the parent databricks-core skill's coverage ('Install the Databricks CLI (>= v0.288.0)...'). Mostly efficient with several trimmable sections, matching anchor 3. | 3 / 5 |
Actionability | Provides an executable non-interactive scaffold command, complete job YAML, runnable notebook code, and a four-step command workflow — mostly copy-paste ready. Minor gaps keep it below anchor 5: unexplained placeholders (<PROFILE>, <run-id>), 'uv run pytest' assumes uv without setup guidance, and the bare cron 'schedule:' example is shown without the resources/jobs nesting context used in every other example. | 4 / 5 |
Workflow Clarity | The Development Workflow gives a clear sequence (Validate -> Deploy -> Run -> Check run status) with a validation checkpoint before deploy, so the batch-operation cap of 3 does not apply. However there is no error-recovery loop (what to do when validate or a run fails) and unit testing sits outside the workflow, so it does not reach anchor 5's explicit feedback loops. | 4 / 5 |
Progressive Disclosure | No bundle files exist, so this is scored on the body's own structure: well-organized sections, basics delegated to the parent databricks-core skill ('Use the parent databricks-core skill for CLI basics'), and documentation links at the end. Minor organization gaps — the sizable CLAUDE.md template is inlined where a reference file would keep SKILL.md as an overview — place it at anchor 4 rather than 5. | 4 / 5 |
Total | 15 / 20 Passed |