Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
30 changes: 30 additions & 0 deletions skills/.curated/databricks-skill-installer/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,30 @@
---
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[P2] Add the per-skill license file

This new curated skill directory only adds SKILL.md, agents/openai.yaml, and assets, but no LICENSE.txt. The repo README says each individual skill’s license should live inside the skill directory as LICENSE.txt; that is especially important here because the PR also adds Databricks logo assets whose license/trademark attribution needs to be clear before distribution.

name: databricks-skill-installer
description: Run `databricks experimental aitools install --global` to install or refresh Databricks skills for Codex and other supported coding agents. Use when Codex needs to bootstrap Databricks skills with the Databricks CLI or install a specific Databricks skill such as `databricks-apps` or `databricks-jobs`.
---

# Databricks Skill Installer

First check:

```bash
databricks -v
```

If the command is missing, follow the upstream Databricks CLI install guide and treat it as the source of truth. In a sandboxed agent session, show the user the appropriate install command from that guide and ask them to run it in their own terminal.

[databricks-cli-install.md](https://github.com/databricks/databricks-agent-skills/blob/main/skills/databricks/databricks-cli-install.md)

Run:

```bash
databricks experimental aitools install --global --agents codex
```

Install one skill with:

```bash
databricks experimental aitools install --global --agents codex --skills databricks-apps
Comment on lines +21 to +27
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[P1] Align installer command with current Databricks docs

The skill’s primary workflow tells Codex to run databricks experimental aitools install --global --agents codex, and the single-skill example repeats that Databricks CLI path. Current Databricks agent-skill documentation instead points users to the Skills CLI (npx skills add databricks/databricks-agent-skills ...) and uses repeated --skill flags for specific skills. Unless this Databricks CLI path is intentionally newer/private, this should be changed to the documented command or backed by an upstream source plus validation, because the current curated skill may fail at its main job.

Reference: https://docs.databricks.com/aws/en/agent-skills/

```

After installation, open the installed Databricks skill under `${CODEX_HOME:-~/.codex}/skills` and follow its upstream `SKILL.md`.
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[P2] Tell users to restart Codex after installing

The last instruction says to open the installed skill and follow its SKILL.md, but the repo’s existing installer flow tells users to restart Codex after installing a skill so discovery picks it up. Add that post-install step here, and clarify whether the current session may only manually inspect the installed files until restart.

7 changes: 7 additions & 0 deletions skills/.curated/databricks-skill-installer/agents/openai.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
interface:
display_name: "Databricks Skills"
short_description: "Install Databricks skills for Codex"
icon_small: "./assets/databricks.svg"
icon_large: "./assets/databricks.png"
brand_color: "#FF3621"
default_prompt: "Use $databricks-skill-installer to install or update Databricks skills from the official Databricks repository."
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.