CtrlK
BlogDocsLog inGet started
Tessl Logo

add-tools

Add tools to your agent and grant required permissions in databricks.yml. Use when: (1) Adding MCP servers, Genie spaces, vector search, or UC functions to agent, (2) Permission errors at runtime, (3) User says 'add tool', 'connect to', 'grant permission', (4) Configuring databricks.yml resources.

68

Quality

83%

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

75%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 a well-structured, mostly executable guide that respects token budget and points outward to example files and sibling skills. Its main gaps are a missing post-deploy validation step and example references that cannot be verified against the bundle.

Suggestions

Add an explicit validation checkpoint after Step 3 (e.g., a command or check to confirm the agent can reach the granted resource before considering the task done), turning the workflow into a validate→fix→retry loop.

Either include the referenced examples/ files (custom-mcp-server.md, local-python-tools.md, and the table's YAML snippets) in the bundle or remove the dangling references so navigation is resolvable.

Flesh out Step 3's deploy command with the required --profile flag inline instead of only deferring to the deploy skill, so the core workflow is self-contained.

DimensionReasoningScore

Conciseness

The body is token-efficient — a resource-type table instead of prose, complete code blocks, and domain-specific details (databricks.yml structure, OpenAI Agents SDK behavior) Claude would not already know — with only minor padding such as "Without this, you'll get permission errors..." restating the risk; above anchor 3 (which expects unnecessary explanation) but not a 5 because the opening line repeats the description and a few sentences could be trimmed.

4 / 5

Actionability

Provides complete, executable McpServer Python and databricks.yml YAML blocks plus the deploy command, covering the common cases copy-paste ready; held at 4 rather than 5 because Step 3 defers deploy specifics to another skill and the profile reminder is generic rather than a fully-specified command.

4 / 5

Workflow Clarity

A clear three-step sequence (add MCP server → grant access in databricks.yml → deploy) with concrete code per step sits above anchor 3; it does not reach 5 because there is no explicit validation/verification checkpoint (e.g., confirming the agent can actually invoke the resource after deploy) despite the failure mode being permission errors.

4 / 5

Progressive Disclosure

Well-sectioned overview with a resource-type table and one-level-deep, clearly signaled references to an examples/ directory and sibling skills; capped at 4 rather than 5 because the referenced example files (examples/custom-mcp-server.md, examples/local-python-tools.md) and the examples/ directory are not present in the bundle to verify, leaving navigation partially unconfirmed.

4 / 5

Total

16

/

20

Passed

Description

91%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 is strong: it pairs a concrete what-statement with an explicit, enumerated Use-when clause containing quoted user trigger phrases. Its only weakness is a narrow action vocabulary and minor boundary overlap with sibling tooling skills.

DimensionReasoningScore

Specificity

Names the domain and concrete actions — "Add tools to your agent and grant required permissions in databricks.yml" — with the Use-when list enumerating specific tasks (MCP servers, Genie spaces, vector search, UC functions); falls at anchor 4 rather than 3 because it lists several specific actions tied to a concrete config artifact, and below 5 because the action set is narrow (add + grant) rather than comprehensive.

4 / 5

Completeness

Clearly states the "what" (add tools and grant permissions in databricks.yml) and provides an explicit, numbered "Use when" clause with four concrete trigger scenarios, matching the anchor 5 example structure.

5 / 5

Trigger Term Quality

Explicitly quotes natural user phrases — "User says 'add tool', 'connect to', 'grant permission'" — alongside runtime cues ("Permission errors at runtime") and domain terms (MCP servers, Genie spaces, vector search, UC functions), giving comprehensive coverage of natural trigger language.

5 / 5

Distinctiveness Conflict Risk

Occupies a clear databricks-agent-tools niche with distinct triggers, but has minor overlap risk with the closely related create-tools and deploy skills it references; not a 5 because the "add tool"/"connect to" triggers could plausibly surface the create-tools skill instead.

4 / 5

Total

18

/

20

Passed

Validation

100%

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

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
databricks/app-templates
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.