Content
86%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 tightly engineered platform skill: routing tables, decision gates, and executable commands dominate, with details correctly pushed to a real, well-organized reference bundle. The only slack is minor redundancy around dashboard-vs-app disambiguation and the absence of an explicit error-recovery loop in the main workflow.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with directives and avoids explaining known concepts ("LLMs already know these frameworks — the challenge is Databricks platform integration"), but the long AI/BI-vs-app disambiguation paragraph ("Don't assume an app is the only way to show data...") partially repeats the description, and the single-sentence data-UI-design paragraph is padded and hard to parse. | 4 / 5 |
Actionability | Nearly every section gives copy-paste-ready commands: `databricks apps manifest`, full `databricks apps init --name ... --features ... --set ...` invocations, `npx @databricks/appkit docs` usage, `databricks apps validate --profile <PROFILE>`, plus a wrong-vs-correct scaffolding example — placeholders like `<pm>`/`<PROFILE>` are explicitly flagged and resolvable via stated rules. | 5 / 5 |
Workflow Clarity | "Development Workflow (FOLLOW THIS ORDER)" gives a required pre-scaffolding Decision Gate, numbered analytics steps with typegen-before-UI ordering, smoke-test selector updates, validate-before-deploy, and post-deploy verification — but no explicit fix-and-retry loop when validation or typegen fails (recovery detail is delegated to references), so it falls just short of the anchor with feedback loops. | 4 / 5 |
Progressive Disclosure | A "Required Reading by Phase" table routes each task to a one-level-deep reference; all 16 referenced files (references/appkit/*.md, platform-guide.md, testing.md, other-frameworks.md) exist in the bundle, and deep-link anchors like overview.md#scaffolding-rules-protocol and genie.md#agent-workflow-tables-first verify — the body holds only overview, routing, and gotchas. | 5 / 5 |
Total | 18 / 20 Passed |