Content
92%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 exemplarily actionable skill: executable commands at every step, a well-sequenced workflow with validation gates and approval checkpoints, and clean one-level-deep reference files. The only trimmable material is mild redundancy between the version-gate script's STOP messages and the prose that follows it.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and imperative with no concept explanations Claude already knows, and the version-gate comments justify genuinely non-obvious choices (subshell, stderr discard, sort -V). Not 5 because the ~26-line version-gate block plus its follow-up paragraph repeat the stop/upgrade conditions in both code messages and prose, which could be tightened. | 4 / 5 |
Actionability | Fully executable guidance throughout: a complete deterministic version-gate bash script, `databricks auth describe --profile <PROFILE>`, per-branch flag choices with concrete commands like `databricks jobs get <JOB_ID> --output json`, and the copy-paste-ready dry-run invocation. Placeholders like <PROFILE> and <TARGET_ARGS> are appropriately parameterized, not pseudocode. | 5 / 5 |
Workflow Clarity | Six clearly sequenced steps (gate -> auth -> directory -> target -> preview -> apply -> result) with explicit validation checkpoints: the version gate must pass before proceeding, dry-run before apply, mandatory user approval before mutations, rerun-preview-and-reapprove on any input change, and routing to troubleshooting on `ok: false`. Feedback loops are present for this file-mutating operation, so the destructive-operation cap does not apply. | 5 / 5 |
Progressive Disclosure | The SKILL.md body is a ~95-line overview that links [examples](references/examples.md), [json-output](references/json-output.md), and [troubleshooting](references/troubleshooting.md) inline at their point of use; all three files exist and references are one level deep (sibling references cross-link only to each other, no further nesting). Structure and navigation match the anchor-5 pattern. | 5 / 5 |
Total | 19 / 20 Passed |