CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

databricks-agent-bricks

Create Agent Bricks: Knowledge Assistants (KA) for document Q&A and Supervisor Agents for multi-agent orchestration (MAS).

65

Quality

82%

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

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

SKILL.md
Quality
Evals
Security

Quality

Content

93%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.

The body is an exemplar of a command-reference skill: lean, copy-paste-ready, and dense with hard-won CLI gotchas, with a clean split into two one-level-deep reference files. The only real gap is workflow presentation — sequences are implied by ordered command blocks with checkpoints noted in comments, rather than explicit numbered steps with a validate/retry loop for the sync-and-status cycle.

DimensionReasoningScore

Conciseness

The body is command-first and lean: every annotation carries non-obvious CLI knowledge Claude would not have (positional args erroring when mixed with --json, 'guidelines is a repeated string', UPDATE_MASK semantics), with zero padding explaining known concepts. Only trivial redundancy (the destructive-delete caveat appears twice), fitting anchor 5 ('Lean and efficient; every token earns its place') better than anchor 4.

5 / 5

Actionability

Fully executable copy-paste-ready CLI commands with realistic JSON payloads, exact field shapes for each tool type in the table, find-by-name jq one-liners, and honest flagging of unverified tool types with a probe instruction ('Run databricks supervisor-agents create-tool --help'). Matches anchor 5 ('Fully executable; copy-paste ready code or commands; specific examples cover the common cases').

5 / 5

Workflow Clarity

The sequence for both workflows is present and mostly checkpointed ('Sync and check status', the CREATING→ONLINE lifecycle, endpoint readiness gated on 'databricks serving-endpoints get', destructive deletes flagged 'confirm the id first'), but the ordering is implied by command blocks rather than an explicit numbered flow, and no validate→fix→retry loop appears in the body (troubleshooting is deferred to references). This matches anchor 4 ('Clear sequence with most checkpoints present; minor validation gaps') better than 5, and the destructive-operation cautions present keep it above 3.

4 / 5

Progressive Disclosure

The body keeps core commands inline and splits details into two real, one-level-deep reference files, clearly signaled by a topic table ('KA source types, index, troubleshooting' / 'UC functions, MCP servers, examples'); the references point back to SKILL.md for commands rather than nesting further. Both referenced files exist and stay one level deep, matching anchor 5 ('Clear overview with well-signaled one-level-deep references; content appropriately split; easy navigation').

5 / 5

Total

19

/

20

Passed

Description

65%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.

The description clearly names both bricks and their purposes with distinctive product terminology, but it stops at 'Create' and omits any 'Use when...' trigger guidance, capping completeness. Adding trigger phrases and one or two more concrete actions (e.g., adding knowledge sources, attaching routing tools) would raise specificity and completeness.

Suggestions

Append a trigger clause such as: 'Use when creating or managing Databricks Agent Bricks — e.g., the user mentions Knowledge Assistants, Supervisor Agents, RAG document Q&A on Volumes, or routing between Genie spaces and KAs.'

List one or two more concrete actions beyond 'Create' — e.g., 'add knowledge sources from Volumes or Vector Search indexes, attach routing tools (Genie spaces, UC functions, MCP servers), and add routing examples' — to lift specificity from 1-2 actions toward comprehensive coverage.

Include the natural synonym 'RAG' (or 'chat with documents') alongside 'document Q&A' so users phrasing the need generically still hit this skill.

DimensionReasoningScore

Specificity

Names the domain ('Agent Bricks', 'Knowledge Assistants', 'Supervisor Agents') and the function of each ('document Q&A', 'multi-agent orchestration (MAS)'), but the only explicit action is 'Create' — no further concrete operations (add knowledge sources, attach tools, add examples). This matches anchor 3 ('Names domain and 1-2 concrete actions, but not comprehensive') better than anchor 4 ('Lists several specific actions').

3 / 5

Completeness

The 'what' is clear (create Knowledge Assistants for document Q&A and Supervisor Agents for orchestration), but there is no 'Use when...' clause or equivalent explicit trigger guidance anywhere — the judging guideline caps this at 3. Not 4, because the 'when' is entirely absent rather than present but imprecise.

3 / 5

Trigger Term Quality

Includes the exact product names a Databricks user would naturally say — 'Agent Bricks', 'Knowledge Assistants (KA)', 'Supervisor Agents', 'multi-agent orchestration (MAS)' — including abbreviations. A few natural terms are missing ('Databricks', 'RAG', 'chat with documents'), matching anchor 4 ('Good keyword coverage; a few natural terms missing') rather than anchor 3, which requires missing common variations of the core terms.

4 / 5

Distinctiveness Conflict Risk

Distinct Databricks product names ('Agent Bricks', 'Knowledge Assistants (KA)', 'Supervisor Agents') establish a clear niche with minimal conflict risk; only the generic phrases 'document Q&A' and 'multi-agent orchestration' carry minor overlap with adjacent skills, which fits anchor 5 ('Clear niche with distinct triggers; minimal conflict risk') more than anchor 4.

5 / 5

Total

15

/

20

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.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository

databricks/databricks-agent-skills

Path

plugins/databricks/codex/skills/databricks-agent-bricks/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.