CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

databricks-aibi-dashboards

Create Databricks AI/BI dashboards. Must use when creating, updating, or deploying Lakeview dashboards as Databricks Dashboard have a unique json structure. CRITICAL: You MUST test ALL SQL queries via CLI BEFORE deploying. Follow guidelines strictly.

66

Quality

83%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

The canonical home for this skill is databricks-aibi-dashboards in databricks/databricks-agent-skills

SKILL.md
Quality
Evals
Security

Quality

Content

81%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A highly actionable, workflow-driven skill body with exceptional CLI/JSON specificity and strong validation checkpoints. Its main weaknesses are token redundancy (critical rules restated 4-5 times) and inline reference-grade material (palettes, theme mechanics) that inflates the body instead of living in a bundle file.

Suggestions

State the --dataset-catalog/--dataset-schema flag-only rule once in a single canonical callout and reference it from the Quick Reference, Step 5, and Implementation Guidelines instead of repeating it ~5 times.

Move the starter palette block and the palette-design/color-theory rules into a reference file (e.g., a theme reference) and keep only the decision-level guidance inline.

Fix the incomplete sentence in Step 3 ("The datasets.querylines in the dashboard json (see example below) must be tested to ensure") and remove the dangling "(see example below)" pointer.

DimensionReasoningScore

Conciseness

The body is dense with genuinely non-obvious specifics (flag-only CLI rules, per-widget versions, JSON gotchas), but the --dataset-catalog/--dataset-schema rule is repeated ~5 times (Quick Reference table, Step 2 note, Step 5 deploy comments, update comments, Implementation Guidelines §1) and the bare-table-name rule 3-4 times. It also explains design knowledge Claude already has ("~4-5% of viewers have color blindness", the 60/30/10 rule, "Don't put red and green adjacent"), so it could be tightened considerably.

3 / 5

Actionability

Fully executable throughout: copy-paste CLI blocks (including DASHBOARD_ID capture via jq and the mkdirs precondition), exact JSON skeletons, correct-vs-wrong field-matching examples, per-widget size tables, and a 13-item pre-deploy checklist. The commands cover all common cases (create, update, publish, trash, schema discovery, parallel multi-query probing).

5 / 5

Workflow Clarity

The NEW DASHBOARD CREATION WORKFLOW is a clearly sequenced 5-step process with explicit validation ("You MUST test ALL SQL queries via CLI BEFORE deploying", "gate on each object's state != \"SUCCEEDED\""), feedback loops ("Fix the query or adjust the story before moving on"), a pre-deploy quality checklist, and lifecycle rules for update→publish. Not 4: explicit checkpoints and error-recovery guidance (exit-code gotcha, 2>&1/jq pitfall) are present at every risky step.

5 / 5

Progressive Disclosure

Navigation is excellent: the Widget Index maps every widget type to a verified anchor in a reference file, the "What are you building?" and Reference Files tables route tasks to files, all 6 bundle reference files are linked, and references are one level deep. Not 5: the ~575-line body inlines reference-grade material (8 starter palettes of hex codes, detailed theme mechanics) that belongs in a reference file, and cross-skill links like ../databricks-metric-views/SKILL.md do not resolve within this bundle.

4 / 5

Total

17

/

20

Passed

Description

82%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description with an explicit what-and-when structure, concrete product-specific triggers, and the key Lakeview synonym. Its only real weakness is that the capability statement is thin — one create verb — while the rest of the text is spent on behavioral directives instead of what the skill covers.

Suggestions

Replace the directive filler ("CRITICAL: You MUST test ALL SQL queries… Follow guidelines strictly.") with capability coverage — e.g., mention widget selection, filters, layout/theming, and CLI-based query validation so the 'what' is comprehensive.

Add natural trigger synonyms users might say, such as "KPIs", "charts", or "dashboard JSON", to broaden keyword coverage.

DimensionReasoningScore

Specificity

"Create Databricks AI/BI dashboards" names the domain with essentially one capability statement; the actions "creating, updating, or deploying" appear only inside the trigger clause, and "CRITICAL: You MUST test ALL SQL queries via CLI BEFORE deploying. Follow guidelines strictly." are behavioral directives rather than capabilities. Not 4: the gaps are more than minor (no mention of widgets, filters, layout, or theming); not 2: the domain and dashboard lifecycle actions are explicitly named.

3 / 5

Completeness

It explicitly answers both questions: what ("Create Databricks AI/BI dashboards") and when ("Must use when creating, updating, or deploying Lakeview dashboards"), with concrete trigger phrases. Not 4: the 'when' clause is already explicit and specific, which is exactly what the 4-anchor flags as missing.

5 / 5

Trigger Term Quality

Natural user terms are present — "Databricks", "AI/BI dashboards", "Lakeview dashboards", "deploying" — including the key product-name synonym (Lakeview). Not 5: common phrasings a user might say such as "KPI", "chart", "visualization", or "dashboard JSON" are missing; not 3: the primary synonym variation is covered.

4 / 5

Distinctiveness Conflict Risk

"Databricks AI/BI" plus "Lakeview dashboards" pins a clear niche with distinct, product-specific triggers and minimal overlap risk; a user asking for this would not be routed to a generic document- or charting skill. Not 4: there is no meaningful overlap with a closely related skill's trigger terms.

5 / 5

Total

17

/

20

Passed

Validation

81%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (575 lines); consider splitting into references/ and linking

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

relative_links

Relative link issues: 5 suspicious

Warning

Total

13

/

16

Passed

Repository

databricks/databricks-agent-skills

Path

plugins/databricks/codex/skills/databricks-aibi-dashboards/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.