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 exceptionally actionable, well-structured skill body: mandatory decision gates, explicit validation checkpoints, real gotchas with quoted error messages, and clean one-level-deep reference routing. The only weakness is duplicated content (the 26-char naming rule stated three times, dashboard-vs-app guidance repeated from the description) that could be trimmed for token efficiency.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with non-obvious platform specifics Claude cannot know (1 MB analytics-event payload cap, CLI >= v1.20.0 auth-mode gate, getByLabelText not existing in Playwright, no-double-type-assertion lint), so most tokens earn their place. However, real repetition exists: the 26-character app-name rule appears three times (Generic Guidelines, Scaffolding, Directory Naming sections) and the dashboard-vs-app disambiguation overlaps the frontmatter description. Anchor 4 ('efficient; minor instances that could be trimmed') fits better than 3, since the padding is duplication rather than explanation of known concepts. | 4 / 5 |
Actionability | Copy-paste-ready commands throughout: exact 'databricks apps init --name <NAME> --features ... --set ...' invocations, wrong-vs-correct examples for common mistakes, quoted error strings ('INVALID_REQUEST: Event exceeds max size of 1048576 bytes'), and post-deploy verification commands with specific fields to check ('app_status.state: RUNNING'). Fully executable and covers the common cases. | 5 / 5 |
Workflow Clarity | 'Development Workflow (FOLLOW THIS ORDER)' with numbered steps, a REQUIRED Data Access Decision Gate before scaffolding, explicit validation checkpoints ('databricks apps validate', 'verify all queries show ✓', 'DO NOT write UI code before running typegen'), a conflict-detection STOP rule in the Scaffolding Rules Protocol, and post-deploy verification. Clear sequencing with explicit validation and error-recovery feedback loops. | 5 / 5 |
Progressive Disclosure | A 'Required Reading by Phase' table maps each task to exactly one reference file; all 18 referenced paths (references/*.md and references/appkit/*.md) exist on disk and are one level deep. The body stays an overview/routing layer while details (SQL, frontend, Genie, Lakebase, platform rules) are appropriately split into separate files. | 5 / 5 |
Total | 19 / 20 Passed |