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.
A well-engineered skill body: an ordered workflow with mandatory decision gates and explicit validation checkpoints, copy-paste-ready CLI commands, and clean progressive disclosure into 18 verified reference files. The only notable flaw is modest redundancy — disambiguation prose repeated between description and body, and the app-name rule stated three times — which costs a little token efficiency.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with directives, commands, and gotchas and explains almost nothing Claude already knows, but there is redundant repetition — the dashboard-vs-app disambiguation from the description is restated in the long paragraphs at the top, and the ≤26-char lowercase-hyphen name rule appears three times (Generic Guidelines, Scaffolding section, Directory Naming) — fitting anchor 4 (minor trims possible) rather than anchor 5. | 4 / 5 |
Actionability | Fully executable, copy-paste-ready commands cover the common cases: `databricks apps manifest`, `databricks apps init --name ... --features ... --set ...`, `npx @databricks/appkit docs`, `<pm> run typegen`, `databricks apps validate --profile`, and post-deploy `apps get`/`apps logs`, plus a wrong-vs-right scaffolding example — anchor 5. | 5 / 5 |
Workflow Clarity | "Development Workflow (FOLLOW THIS ORDER)" sequences the decision gate before scaffolding with explicit numbered steps and validation checkpoints (typegen "verify all queries show ✓" before writing UI, `apps validate` before deploy, post-deploy status verification with the PAT/OAuth caveat), and the Required Reading by Phase table acts as a checklist — anchor 5. | 5 / 5 |
Progressive Disclosure | The body works as an overview and routing layer: a phase-indexed table signals one-level-deep references for each task, a routing table maps data-access patterns to guides, and all 18 referenced files (references/*.md and references/appkit/*.md) exist on disk — anchor 5. | 5 / 5 |
Total | 19 / 20 Passed |