Skip to content

Allow to install skills globally, support ".agents" directory, and Cursor #515

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
alexott wants to merge 1 commit into
base: main
Choose a base branch
from
+95 −14
Open

Allow to install skills globally, support ".agents" directory, and Cursor #515

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
35 changes: 33 additions & 2 deletions databricks-skills/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ Skills that teach Claude Code how to work effectively with Databricks - providin

## Installation

Run from your **project root** (the directory where you want `.claude/skills` created).
Run from your **project root** (the directory where you want `.claude/skills` created), or pass `--global` to install into your home directory instead.

### From this repository (local script)

Expand Down Expand Up @@ -57,7 +57,38 @@ curl -sSL https://raw.githubusercontent.com/databricks-solutions/ai-dev-kit/main
curl -sSL https://raw.githubusercontent.com/databricks-solutions/ai-dev-kit/main/databricks-skills/install_skills.sh | bash -s -- --install-to-genie --profile prod
```

`--install-to-genie` uploads the tree under `./.claude/skills` to the workspace (requires the `databricks` CLI).
`--install-to-genie` uploads the tree under `./.claude/skills` to the workspace (requires the `databricks` CLI). By default it uploads to `/Users/<you>/.assistant/skills`. Combine with `--global` to upload to the workspace-shared location `/Workspace/.assistant/skills` instead — useful when you want a single set of skills available to every user in the workspace.

### Install location

By default skills install to `./.claude/skills` in the current directory. Use these flags to change the destination:

| Flags | Destination | Use case |
| ---------------------- | ------------------------- | ----------------------------------------- |
| _(none)_ | `./.claude/skills` | Per-project install for Claude Code |
| `--global` | `~/.claude/skills` | Make skills available in every project |
| `--agents` | `./.agents/skills` | Per-project install for Codex/Copilot/... |
| `--global --agents` | `~/.agents/skills` | Global install for multi-agent tools |
| `--cursor` | `./.cursor/skills` | Per-project install for Cursor IDE |
| `--cursor --global` | `~/.cursor/skills` | Global install for Cursor IDE |

Examples:

```bash
# Install all skills globally for Claude Code
./databricks-skills/install_skills.sh --global

# Install for Cursor in the current project
./databricks-skills/install_skills.sh --cursor

# Same via curl, globally for the .agents/ convention
curl -sSL https://raw.githubusercontent.com/databricks-solutions/ai-dev-kit/main/databricks-skills/install_skills.sh | bash -s -- --global --agents

# Install + upload to workspace-shared Genie skills path (/Workspace/.assistant/skills)
./databricks-skills/install_skills.sh --global --install-to-genie
```

When `--global` is set, the installer skips the project-root sanity check. With `--install-to-genie`, `--global` also switches the workspace destination from `/Users/<you>/.assistant/skills` to the shared `/Workspace/.assistant/skills`.

This creates `.claude/skills/` and downloads all skills. Claude Code loads them automatically.
- **Databricks skills** are downloaded from this repository
Expand Down
74 changes: 62 additions & 12 deletions databricks-skills/install_skills.sh
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -21,6 +21,11 @@
# ./install_skills.sh --install-to-genie --profile prod --local
# ./install_skills.sh --list # List available skills
# ./install_skills.sh --help # Show help
# ./install_skills.sh --global # Install to ~/.claude/skills (Claude global config)
# ./install_skills.sh --agents # Install to .agents/skills (multi-agent project)
# ./install_skills.sh --global --agents # Install to ~/.agents/skills (global agents config)
# ./install_skills.sh --cursor # Install to .cursor/skills (Cursor IDE)
# ./install_skills.sh --cursor --global # Install to ~/.cursor/skills (Cursor global)
#

set -e
Expand All @@ -38,6 +43,9 @@ REPO_RAW_URL="https://raw.githubusercontent.com/databricks-solutions/ai-dev-kit/
SKILLS_DIR=".claude/skills"
INSTALL_FROM_LOCAL=false
INSTALL_TO_GENIE=false
INSTALL_GLOBAL=false
INSTALL_AGENTS=false
INSTALL_CURSOR=false
# Databricks CLI profile for workspace upload (only used with --install-to-genie)
DB_PROFILE="${DATABRICKS_CONFIG_PROFILE:-DEFAULT}"
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
Expand Down Expand Up @@ -187,9 +195,13 @@ show_help() {
echo " --local Install from local files instead of downloading"
echo " --install-to-genie After install, upload ./.claude/skills to workspace"
echo " /Users/<you>/.assistant/skills for Genie Code (uses cwd; requires databricks CLI)"
echo " With --global: uploads to /Workspace/.assistant/skills (workspace-shared)"
echo " --profile <name> Databricks config profile for workspace upload (default: DEFAULT or \$DATABRICKS_CONFIG_PROFILE)"
echo " --mlflow-version <ref> Pin MLflow skills to specific version/branch/tag (default: main)"
echo " --apx-version <ref> Pin APX skills to specific version/branch/tag (default: main)"
echo " --global Install to user's home directory (~/.claude/skills by default)"
echo " --agents Install to .agents/skills (multi-agent); with --global: ~/.agents/skills"
echo " --cursor Install to .cursor/skills (Cursor IDE); with --global: ~/.cursor/skills"
echo ""
echo "Examples:"
echo " ./install_skills.sh # Install all skills"
Expand All @@ -201,7 +213,13 @@ show_help() {
echo " ./install_skills.sh --local # Install all from local directory"
echo " ./install_skills.sh --install-to-genie # Install all, then upload to workspace for Genie Code"
echo " ./install_skills.sh --install-to-genie --profile prod # Same with explicit Databricks CLI profile"
echo " ./install_skills.sh --install-to-genie --global # Upload to /Workspace/.assistant/skills (shared)"
echo " ./install_skills.sh --list # List available skills"
echo " ./install_skills.sh --global # Install to ~/.claude/skills"
echo " ./install_skills.sh --agents # Install to .agents/skills"
echo " ./install_skills.sh --global --agents # Install to ~/.agents/skills"
echo " ./install_skills.sh --cursor # Install to .cursor/skills"
echo " ./install_skills.sh --cursor --global # Install to ~/.cursor/skills"
echo ""
echo -e "${GREEN}Databricks Skills:${NC}"
for skill in $DATABRICKS_SKILLS; do
Expand Down Expand Up @@ -308,17 +326,24 @@ install_skills_to_genie_workspace() {
echo -e "Local skills (cwd-relative): ${SKILLS_DIR}/ → ${abs_skills_dir}"
echo ""

local user_name
user_name=$(databricks current-user me --profile "$DB_PROFILE" --output json 2>/dev/null | python3 -c "import sys, json; d=json.load(sys.stdin); print(d.get('userName', ''))" 2>/dev/null || echo "")
if [ -z "$user_name" ]; then
echo -e "${RED}Error: Could not determine workspace user. Check authentication and --profile.${NC}"
return 1
fi
local skills_path
if [ "$INSTALL_GLOBAL" = true ]; then
skills_path="/Workspace/.assistant/skills"
echo -e "Workspace path: ${skills_path} (global)"
echo ""
else
local user_name
user_name=$(databricks current-user me --profile "$DB_PROFILE" --output json 2>/dev/null | python3 -c "import sys, json; d=json.load(sys.stdin); print(d.get('userName', ''))" 2>/dev/null || echo "")
if [ -z "$user_name" ]; then
echo -e "${RED}Error: Could not determine workspace user. Check authentication and --profile.${NC}"
return 1
fi

local skills_path="/Users/$user_name/.assistant/skills"
echo -e "Workspace user: ${user_name}"
echo -e "Workspace path: ${skills_path}"
echo ""
skills_path="/Users/$user_name/.assistant/skills"
echo -e "Workspace user: ${user_name}"
echo -e "Workspace path: ${skills_path}"
echo ""
fi

echo -e "${GREEN}Creating workspace skills directory...${NC}"
databricks workspace mkdirs "$skills_path" --profile "$DB_PROFILE" 2>/dev/null || true
Expand Down Expand Up @@ -552,6 +577,18 @@ while [ $# -gt 0 ]; do
INSTALL_FROM_LOCAL=true
shift
;;
--global)
INSTALL_GLOBAL=true
shift
;;
--agents)
INSTALL_AGENTS=true
shift
;;
--cursor)
INSTALL_CURSOR=true
shift
;;
--install-to-genie|--deploy-to-assistant)
INSTALL_TO_GENIE=true
shift
Expand Down Expand Up @@ -610,14 +647,27 @@ if [ -z "$SKILLS_TO_INSTALL" ]; then
SKILLS_TO_INSTALL="$ALL_SKILLS"
fi

# Resolve SKILLS_DIR based on --cursor, --agents, and --global
if [ "$INSTALL_CURSOR" = true ] && [ "$INSTALL_GLOBAL" = true ]; then
SKILLS_DIR="${HOME}/.cursor/skills"
elif [ "$INSTALL_CURSOR" = true ]; then
SKILLS_DIR=".cursor/skills"
elif [ "$INSTALL_AGENTS" = true ] && [ "$INSTALL_GLOBAL" = true ]; then
SKILLS_DIR="${HOME}/.agents/skills"
elif [ "$INSTALL_GLOBAL" = true ]; then
SKILLS_DIR="${HOME}/.claude/skills"
elif [ "$INSTALL_AGENTS" = true ]; then
SKILLS_DIR=".agents/skills"
fi

# Header
echo -e "${BLUE}╔════════════════════════════════════════════════════════════╗${NC}"
echo -e "${BLUE}║ Databricks Skills Installer for Claude Code ║${NC}"
echo -e "${BLUE}╚════════════════════════════════════════════════════════════╝${NC}"
echo ""

# Check if we're in a git repo or project directory
if [ ! -d ".git" ] && [ ! -f "pyproject.toml" ] && [ ! -f "package.json" ] && [ ! -f "databricks.yml" ]; then
# Check if we're in a git repo or project directory (skip when installing globally)
if [ "$INSTALL_GLOBAL" = false ] && [ ! -d ".git" ] && [ ! -f "pyproject.toml" ] && [ ! -f "package.json" ] && [ ! -f "databricks.yml" ]; then
echo -e "${YELLOW}Warning: This doesn't look like a project root directory.${NC}"
echo -e "Current directory: $(pwd)"
read -p "Continue anyway? (y/N): " confirm
Expand Down