Content
85%Reviews 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 that uses tables, concrete commands, and one-level-deep references to keep the overview lean while routing detail to bundle files. The main weakness is redundancy of the app-naming rule across three sections, which slightly hurts token efficiency.
Suggestions
State the app-naming constraint (≤26 chars, lowercase letters/numbers/hyphens, dev- prefix allowance) once in Generic Guidelines and reference it from the Scaffolding and Directory Naming sections instead of restating it three times.
In the 'Required Reading by Phase' table, make the Scaffolding row a brief pointer to the detailed AppKit section rather than re-summarizing the manifest/init --features/--set flow inline.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly dense and actionable, but the app-naming rule (≤26 chars, lowercase/hyphens) is restated in three places (Generic Guidelines, App Manifest and Scaffolding, and Directory Naming), and the manifest/init scaffolding guidance is summarized in the phase table and then repeated in detail in the AppKit section. | 2 / 3 |
Actionability | Provides concrete, copy-paste-ready commands throughout (`databricks apps manifest`, `databricks apps init --name ... --features ... --set ...`, `npm run typegen`, `databricks apps validate`, `npx @databricks/appkit docs`) plus explicit WRONG/CORRECT scaffolding examples. | 3 / 3 |
Workflow Clarity | The "Development Workflow (FOLLOW THIS ORDER)" section gives a numbered 1–6 sequence with explicit verification checkpoints ("verify all queries show ✓", `databricks apps validate`) and ordering warnings ("DO NOT write UI code before running typegen"); scaffolding has its own manifest-first sequence. | 3 / 3 |
Progressive Disclosure | The body is a concise overview that points to one-level-deep references (references/appkit/*.md, references/platform-guide.md, references/other-frameworks.md, references/testing.md), all verified to exist, organized via a 'Required Reading by Phase' table that signals when to consult each file. | 3 / 3 |
Total | 11 / 12 Passed |