Official agent skill

Bump CLI Compatibility Manifest

by databricks in databricks/cli

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

OfficialCustom licenceAuto-check: notesDevelopment

Install Bump CLI Compatibility Manifest

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

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

GitHub CLI
$ gh skill install databricks/cli bump-cli-compat --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-cli-compat .claude/skills/bump-cli-compat && 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-cli-compat
GitHub stars
404
Token cost
~1.3k tokens
SKILL.md length
449 words
Files
1
Skills in repo
5
Repo updated
First seen
Licence
Custom licence

At a glance

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

  • Works in 6 steps: Resolve versions → Validate tags exist → Read current manifest → …
  • Recording a new AppKit release in the CLI compatibility manifest
  • SKILL.md covers Arguments, Workflow and Examples
  • Calls gh, git and go

What it does

A maintainer skill that edits `internal/build/cli-compat.json` after an AppKit or Agent Skills release. You can pass `--appkit` and `--skills` versions without a `v` prefix, or give none and let the agent read the latest tags from GitHub with the `gh` CLI. It shows the resolved versions, asks whether they have been evaluated with no regressions, and does not continue until you confirm.

It then checks that the matching Git tags exist, including the `template-v` tag used by `apps init`, reads the current manifest, and asks whether the release needs new CLI behavior: new templates that require new logic in `apps init`, or skills that call CLI commands older versions lack. With no breaking change it updates the highest versioned entry in place, because the manifest is range-based; breaking changes take a separate path. The result is validated and a pull request is created.

When your agent uses it

  • Recording a new AppKit release in the CLI compatibility manifest
  • Updating the manifest after an Agent Skills release
  • Deciding whether a release is a breaking or non-breaking compatibility bump

Example prompts

  • “Bump cli-compat to AppKit 0.28.0 and Agent Skills 0.1.6.”
  • “A new AppKit release is out; update the compatibility manifest and open the PR.”
  • “Update cli-compat with the latest versions from the GitHub tags.”

Requirements

  • A checkout of the databricks/cli repository
  • The GitHub CLI (`gh`) with access to the AppKit and Agent Skills tags
  • Pre-approved tools (allowed-tools): Read, Edit, Write, Bash, Glob, Grep, AskUserQuestion

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. Resolve versions
  2. Validate tags exist
  3. Read current manifest
  4. Determine update type
  5. Validate
  6. Create branch, commit, and PR

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
    • AskUserQuestion

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • gh
    • git
    • go

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

  • Network

    No URLs in SKILL.md. Its commands use gh and git, which can reach the network depending on how they are called.

    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

Bump CLI Compatibility Manifest loads about 1.3k tokens when it runs. Until then it costs about 79 tokens; SKILL.md has 449 words of instructions outside code blocks.

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

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.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Read, Edit, Write, Bash, Glob, Grep, 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 449 words (~1,263 tokens).

“Updates internal/build/cli-compat.json with new AppKit and Agent Skills versions, validates the result, and creates a PR.”

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

Read the full SKILL.md on GitHub

Files

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

Open the folder on GitHubat commit ced3a80

Compare with similar skills

Bump CLI Compatibility Manifest 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.

Bump CLI Compatibility Manifest compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Bump CLI Compatibility Manifest this skilldatabricks/cli404—~1.3kAutomated safety check: NotesCustom licence
Renovate Actions PR Reviewbacknotprop/plannotator9.2k—~640Automated safety check: PassApache-2.0
Apply Renovate PRssivaprasadreddy/sivalabs-agent-skills187—~3kAutomated safety check: PassMIT
Pc CI Dependency Botpartcad/partcad503—~1.9kAutomated safety check: PassApache-2.0
Dependabot Consolidationsillsdev/FieldWorks110—~3.5kAutomated safety check: PassCustom licence
Security Vulnerabilities Patcheraxelixlabs/axelix147—~4.2kAutomated safety check: PassLGPL-3.0

Similar skills

  • Renovate Actions PR Review

    backnotprop/plannotator

    Reviews Renovate pull requests that bump GitHub Actions by checking pinned SHAs against upstream tags, scanning changelogs and confirming workflows stay compatible.

    9.2k GitHub stars~640 tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Apply Renovate PRs

    sivaprasadreddy/sivalabs-agent-skills

    Apply the changes from all open Renovate bot pull requests of a GitHub repository into the local working tree.

    187 GitHub stars~3k tokensUpdated 2 days ago
    DevelopmentAuto-check passed
  • Pc CI Dependency Bot

    partcad/partcad

    Sweep the open dependency-bot pull requests once - rebase the stale ones, re-trigger infrastructure failures, and merge the green patch and minor updates.

    503 GitHub stars~1.9k tokensUpdated today
    DevelopmentAuto-check passed
  • Dependabot Consolidation

    sillsdev/FieldWorks

    Combine several open Dependabot pull requests into a single branch and PR: enumerate the open Dependabot PRs, cherry-pick them onto fresh main, rewrite commit messages to satisfy…

    110 GitHub stars~3.5k tokensUpdated today
    DevelopmentAuto-check passed
  • Create batched Dependabot-style pull requests for GitHub security findings in axelixlabs/axelix, grouped by dependency surface such as master/front-end, master/build.gradle.kts, or starter Gradle…

    147 GitHub stars~4.2k tokensUpdated yesterday
    SecurityAuto-check passed
  • Performing Sca Dependency Scanning With Snyk

    mukul975/Anthropic-Cybersecurity-Skills

    This skill covers implementing Software Composition Analysis (SCA) using Snyk to detect vulnerable open-source dependencies in CI/CD pipelines.

    34k GitHub stars~2.2k tokensUpdated 1 mo ago
    Legal & ComplianceAuto-check passed

More from databricks/cli

  • Official

    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.

    404 GitHub stars~2k 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

Categories

Questions about Bump CLI Compatibility Manifest

What does Bump CLI Compatibility Manifest do?

Updates the Databricks CLI's cli-compat.json with new AppKit and Agent Skills versions and opens a pull request for the change. json` after an AppKit or Agent Skills release. You can pass `--appkit` and `--skills` versions without a `v` prefix, or give none and let the agent read the latest tags from GitHub with the `gh` CLI.

When should I use Bump CLI Compatibility Manifest?

Bump CLI Compatibility Manifest fits situations like: recording a new AppKit release in the CLI compatibility manifest; updating the manifest after an Agent Skills release; deciding whether a release is a breaking or non-breaking compatibility bump.

How do I install Bump CLI Compatibility Manifest in Claude Code?

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

How do I install Bump CLI Compatibility Manifest in Codex?

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

Can I use Bump CLI Compatibility Manifest 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-cli-compat -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-cli-compat, .gemini/skills/bump-cli-compat, .github/skills/bump-cli-compat and .opencode/skills/bump-cli-compat in your project.

What does Bump CLI Compatibility Manifest need to run?

Going by SKILL.md and its folder, Bump CLI Compatibility Manifest needs the command-line tools its instructions call (gh, git and go). Our summary lists: A checkout of the databricks/cli repository; The GitHub CLI (`gh`) with access to the AppKit and Agent Skills tags. Its frontmatter pre-approves these tools: Read, Edit, Write, Bash, Glob, Grep, AskUserQuestion.

Does Bump CLI Compatibility Manifest access the network?

SKILL.md contains no URLs. Its commands use gh and git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Bump CLI Compatibility Manifest safe to install?

Our automated static check of SKILL.md found notes only (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 Bump CLI Compatibility Manifest use?

Bump CLI Compatibility Manifest 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 Bump CLI Compatibility Manifest use?

About 1.3k tokens (SKILL.md is roughly 5.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 Bump CLI Compatibility Manifest?

Skills that share tags, products or a category with Bump CLI Compatibility Manifest: Renovate Actions PR Review (backnotprop/plannotator, 9.2k stars), Apply Renovate PRs (sivaprasadreddy/sivalabs-agent-skills, 187 stars), Pc CI Dependency Bot (partcad/partcad, 503 stars) and Dependabot Consolidation (sillsdev/FieldWorks, 110 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Bump CLI Compatibility Manifest?

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.