Official agent skill

Databricks CLI SDK Bump

by databricks in databricks/cli

Bumps the databricks-sdk-go dependency in the Databricks CLI together with its pinned OpenAPI spec SHA, then regenerates the files that depend on them.

OfficialCustom licenceAuto-check: notesDevelopment

Install Databricks CLI SDK Bump

skills CLI
$ npx skills add databricks/cli --skill bump-sdk -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install databricks/cli bump-sdk --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/databricks/cli.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/bump-sdk .claude/skills/bump-sdk && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
bump-sdk
GitHub stars
404
Token cost
~2k tokens
SKILL.md length
1,044 words
Files
1
Skills in repo
5
Repo updated
First seen
Licence
Custom licence

At a glance

Bumps the databricks-sdk-go dependency in the Databricks CLI together with its pinned OpenAPI spec SHA, then regenerates the files that depend on them.

  • Upgrading the Go SDK dependency in the Databricks CLI
  • SKILL.md covers Steps and Stacking and rebasing
  • Calls go, git and gh; reaches raw.githubusercontent.com and astral.sh
  • Updating the pinned OpenAPI spec SHA

What it does

The SDK version lives in `go.mod` and the pinned spec SHA in `.codegen/_openapi_sha`, and the two must move as a pair. The agent resolves the target version, using the one you give, the newest release tag, or the version a given Terraform provider release uses, reads the matching OpenAPI SHA from the SDK at that tag, runs `go get` for the new version, writes the SHA and runs `go mod tidy` to confirm that only the SDK line changed in `go.mod` and `go.sum`.

Generated files such as `.codegen/cli.json`, the `cmd/workspace` and `cmd/account` code, the bundle schema files and the Python bundle package are regenerated rather than edited by hand, starting with `./task generate-clijson`, which builds genkit and the spec from a Universe checkout. Python tasks run through `uv`, which provisions the interpreter each package pins, so the system Python version is not chased. The excerpt is cut off after the generation step.

When your agent uses it

  • Upgrading the Go SDK dependency in the Databricks CLI
  • Updating the pinned OpenAPI spec SHA
  • Moving the CLI to the SDK version used by a Terraform provider release

Example prompts

  • “Bump databricks-sdk-go to the latest release and regenerate everything.”
  • “Update the CLI to the SDK version used by the latest Terraform provider release.”
  • “Set .codegen/_openapi_sha to match the new SDK tag and fix the generated-code fallout.”

Requirements

  • A Go toolchain
  • `uv` for the Python codegen tasks
  • A local Universe checkout (`UNIVERSE_DIR`) for generating `cli.json`
  • Pre-approved tools (allowed-tools): Read, Edit, Write, Bash, Glob, Grep, WebFetch, AskUserQuestion

What it can do on your machine

Read from SKILL.md and the folder at commit ced3a80. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Edit
    • Write
    • Bash
    • Glob
    • Grep
    • WebFetch
    • AskUserQuestion

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • go
    • git
    • gh
    • curl
    • sh
    • uv

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • raw.githubusercontent.com
    • astral.sh
    • github.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Databricks CLI SDK Bump loads about 2k tokens when it runs. Until then it costs about 52 tokens; SKILL.md has 1,044 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~52
When it runs · the whole SKILL.md, loaded when a task matches
~2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePipes a well-known installer script into a shellSKILL.md:14
    ` is too old (e.g. 3.9), install `uv` (`curl -LsSf https://astral.sh/uv/install.sh | sh`) rather than touching the syste
  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Read, Edit, Write, Bash, Glob, Grep, WebFetch, AskUserQuestion

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 1,044 words (~2,013 tokens).

“The SDK version lives in go.mod (github.com/databricks/databricks-sdk-go) and the pinned spec SHA lives in .codegen/_openapi_sha. These two move as a pair; everything else in this skill is regenerated from them or is fallout you fix by hand. Do not hand-edit…”

— opening of SKILL.md by databricks, Custom licence
name
bump-sdk
allowed-tools
Read, Edit, Write, Bash, Glob, Grep, WebFetch, AskUserQuestion
user-invocable
true

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .agents/skills/bump-sdk of databricks/cli.

Open the folder on GitHubat commit ced3a80

Compare with similar skills

Databricks CLI SDK Bump next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Databricks CLI SDK Bump compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Databricks CLI SDK Bump this skilldatabricks/cli404—~2kAutomated safety check: NotesCustom licence
Running CI PreflightPostHog/posthog-foss721—~1.5kAutomated safety check: PassMIT
Datadog Data Source GeneratorDataDog/terraform-provider-datadog468—~2.7kAutomated safety check: PassMPL-2.0
Arandu Shared Modules Guidearandu-io/arandu281—~1.8kAutomated safety check: PassMIT
Databricks Model Servingdatabricks/databricks-agent-skills3451 repos~3.3kAutomated safety check: PassCustom licence
Golang Swaggercontext-labs/whip1.1k2 repos~2.3kAutomated safety check: PassMIT

Similar skills

  • Running CI Preflight

    PostHog/posthog-foss

    Official

    Catch the deterministic CI failures reachable from your diff before pushing, with hogli ci:preflight.

    721 GitHub stars~1.5k tokensUpdated today
    Backend & APIsAuto-check passed
  • Datadog Data Source Generator

    DataDog/terraform-provider-datadog

    Official

    Generates a Datadog Terraform provider data source from an OpenAPI operation with tfgen and opens a review-ready GitHub PR with a risk scan and testing guide.

    468 GitHub stars~2.7k tokensUpdated yesterday
    DevOps & CloudAuto-check passed
  • Decides whether a feature belongs in the application or in one of five shared Arandu modules before adding permissions, wallets, tags, Markdown rendering or API docs.

    281 GitHub stars~1.8k tokensUpdated 3 days ago
    Backend & APIsAuto-check passed
  • Databricks Model Serving

    databricks/databricks-agent-skills

    Official

    Databricks Model Serving endpoint lifecycle and ops. An agent skill from databricks/databricks-agent-skills.

    345 GitHub starsUsed in 1 repo~3.3k tokens
    AI & LLM EngineeringAuto-check passed
  • Golang Swagger

    context-labs/whip

    Golang OpenAPI/Swagger docs with swaggo/swag — annotations (@Summary, @Param, @Success, @Router, @Security), swag init, framework integrations (gin, echo, fiber, chi), security definitions, struct…

    1.1k GitHub starsUsed in 2 repos~2.3k tokens
    Backend & APIsAuto-check passed
  • Zod

    jasonjgardner/blockbench-mcp-plugin

    Zod schema validation best practices for type safety, parsing, and error handling.

    488 GitHub starsUsed in 3 repos~1.4k tokens
    DevelopmentAuto-check passed

More from databricks/cli

  • Official

    Updates the Databricks CLI's cli-compat.json with new AppKit and Agent Skills versions and opens a pull request for the change.

    404 GitHub stars~1.3k tokensUpdated today
    Auto-check: notes
  • Updates the default serverless environment version in Databricks CLI bundle templates together with its coupled Python and DB Connect pins.

    404 GitHub stars~1.3k tokensUpdated today
    Auto-check: notes
  • Official

    Walks through reserving a directory for a team in the Databricks CLI repo and wiring GitHub CODEOWNERS so that team's approvals are required for its area.

    404 GitHub stars~851 tokensUpdated today
    Auto-check: notes
  • Official

    Pre-PR checklist for the Databricks CLI repository: run the same format and lint checks as CI, scrub the diff, fill the PR template concisely and add a changelog entry.

    404 GitHub stars~1.5k tokensUpdated today
    Auto-check passed

Questions about Databricks CLI SDK Bump

What does Databricks CLI SDK Bump do?

Bumps the databricks-sdk-go dependency in the Databricks CLI together with its pinned OpenAPI spec SHA, then regenerates the files that depend on them. codegen/_openapi_sha`, and the two must move as a pair.sum`.

When should I use Databricks CLI SDK Bump?

Databricks CLI SDK Bump fits situations like: upgrading the Go SDK dependency in the Databricks CLI; updating the pinned OpenAPI spec SHA; moving the CLI to the SDK version used by a Terraform provider release.

How do I install Databricks CLI SDK Bump in Claude Code?

Run `npx skills add databricks/cli --skill bump-sdk -a claude-code`. Or copy the skill folder (.agents/skills/bump-sdk in databricks/cli) into .claude/skills/bump-sdk in your project. Claude Code loads it when a task matches its description.

How do I install Databricks CLI SDK Bump in Codex?

Run `npx skills add databricks/cli --skill bump-sdk -a codex`. Or copy the skill folder (.agents/skills/bump-sdk in databricks/cli) into .agents/skills/bump-sdk in your project. Codex loads it when a task matches its description.

Can I use Databricks CLI SDK Bump in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add databricks/cli --skill bump-sdk -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/bump-sdk, .gemini/skills/bump-sdk, .github/skills/bump-sdk and .opencode/skills/bump-sdk in your project.

What does Databricks CLI SDK Bump need to run?

Going by SKILL.md and its folder, Databricks CLI SDK Bump needs the command-line tools its instructions call (go, git, gh, curl, sh and uv). Our summary lists: A Go toolchain; `uv` for the Python codegen tasks; A local Universe checkout (`UNIVERSE_DIR`) for generating `cli.json`. Its frontmatter pre-approves these tools: Read, Edit, Write, Bash, Glob, Grep, WebFetch, AskUserQuestion.

Does Databricks CLI SDK Bump access the network?

SKILL.md names 3 domains. In commands or code: raw.githubusercontent.com, astral.sh and github.com; the agent is likely to contact these when it follows the instructions. This is read from the text; nothing was executed.

Is Databricks CLI SDK Bump safe to install?

Our automated static check of SKILL.md found notes only (pipes a well-known installer script into a shell; pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Databricks CLI SDK Bump use?

Databricks CLI SDK Bump has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Databricks CLI SDK Bump use?

About 2k tokens (SKILL.md is roughly 8.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Databricks CLI SDK Bump?

Skills that share tags, products or a category with Databricks CLI SDK Bump: Running CI Preflight (PostHog/posthog-foss, 721 stars), Datadog Data Source Generator (DataDog/terraform-provider-datadog, 468 stars), Arandu Shared Modules Guide (arandu-io/arandu, 281 stars) and Databricks Model Serving (databricks/databricks-agent-skills, 345 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Databricks CLI SDK Bump?

databricks (a GitHub organization, an official publisher) maintains it in databricks/cli, which has 404 GitHub stars. The repository holds 5 skills in this directory. The repository was last updated on October 7, 2026.

Source: databricks/cli on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.