CtrlK
BlogDocsLog inGet started
Tessl Logo

databricks-agent-bricks

Create and manage Databricks Agent Bricks: Knowledge Assistants (KA) for document Q&A, Genie Spaces for SQL exploration, and Supervisor Agents (MAS) for multi-agent orchestration. Use when building conversational AI applications on Databricks.

72

Quality

90%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

80%

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

The body is highly actionable and token-efficient, with concrete tool schemas and a complete example. Its weaknesses are missing validation/feedback checkpoints in the workflow for destructive operations, and progressive-disclosure gaps where referenced detail files are absent and reference-style content is inlined.

Suggestions

Add an explicit validation checkpoint to the workflow — e.g., poll `manage_ka(action="get")` / `manage_mas(action="get")` until `endpoint_status` is `ONLINE` before adding examples, with a fix/retry path for `OFFLINE` or stuck `PROVISIONING` states.

Create the referenced `1-knowledge-assistants.md` and `2-supervisor-agents.md` bundle files (or remove the See Also entries) so signaled references resolve to real one-level-deep content.

Move the full manage_ka/manage_mas parameter reference into a separate reference file and keep SKILL.md as a tighter overview pointing to it, improving progressive disclosure.

DimensionReasoningScore

Conciseness

The body is dense reference material — an overview table, tool signatures, and an executable example — that assumes Claude's competence without explaining concepts like RAG or SQL; the minor "Best Practices" list is short and task-tied, so overall every section earns its place, matching the lean/efficient anchor.

3 / 3

Actionability

Concrete tool signatures with parameters, actions, and return values plus a full copy-paste-ready `manage_mas(...)` Python example with realistic arguments meet the fully-executable anchor; not score 2 because the guidance is complete rather than pseudocode.

3 / 3

Workflow Clarity

The "Typical Workflow" lists a clear sequence (generate data → create brick → wait for provisioning → add examples) with status states, but there are no explicit validation checkpoints or fix/retry feedback loops despite destructive `delete` and batch `create_or_update` actions, capping it at 2 per the destructive-operations guideline.

2 / 3

Progressive Disclosure

"See Also" signals `1-knowledge-assistants.md` and `2-supervisor-agents.md`, but no bundle directories or referenced files exist in the skill, and the full inline tool reference (manage_ka/manage_mas parameter lists) is content that could live one level deeper — fitting the anchor of references present but content that should be separate kept inline.

2 / 3

Total

10

/

12

Passed

Description

100%

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

The description is specific, trigger-rich, and clearly answers both what the skill does and when to use it, with a distinct Databricks Agent Bricks niche. It is a strong, concise description with no notable weaknesses.

DimensionReasoningScore

Specificity

"Create and manage Databricks Agent Bricks: Knowledge Assistants (KA) for document Q&A, Genie Spaces for SQL exploration, and Supervisor Agents (MAS) for multi-agent orchestration" lists multiple concrete actions (create, manage) across three specifically-named brick types with their purposes, matching the score-3 anchor of listing several specific concrete actions.

3 / 3

Completeness

It explicitly answers what ("Create and manage... Knowledge Assistants... Genie Spaces... Supervisor Agents") and when ("Use when building conversational AI applications on Databricks"), satisfying the anchor for clearly answering both what AND when with explicit triggers.

3 / 3

Trigger Term Quality

Natural terms a Databricks user would say are well covered — "Agent Bricks", "Knowledge Assistants", "Genie Spaces", "Supervisor Agents", "conversational AI applications", "Databricks" — rather than jargon, fitting the good-coverage anchor; not score 2 because common variations of the brick names are present.

3 / 3

Distinctiveness Conflict Risk

The "Databricks Agent Bricks" framing plus the "building conversational AI applications on Databricks" trigger carves a clear niche unlikely to fire for unrelated skills; not score 2 because the brick-management scope is distinct even though Genie overlaps a sibling skill.

3 / 3

Total

12

/

12

Passed

Validation

93%

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

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 6 suspicious

Warning

Total

15

/

16

Passed

Repository
databricks-solutions/ai-dev-kit
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.