databricks-skills

Databricks Agent Skills

Skills for AI coding assistants (Claude Code, Cursor, etc.) that provide Databricks-specific guidance.

Installation

For Claude Code:

databricks experimental aitools install

This installs skills to ~/.claude/skills/ for use with Claude Code.

For Cursor:

Run this command in chat:

/add-plugin databricks-skills

Available Skills

• databricks-apps - Build full-stack TypeScript apps on Databricks using AppKit

Structure

Each skill follows the Agent Skills Specification:

skill-name/
├── SKILL.md           # Main skill file with frontmatter + instructions
└── references/        # Additional documentation loaded on demand

Development

Adding New Skills

When experimenting with new skill variations, create a "subskill" that references the main skill and adds specific guidance:

---
name: "ai-databricks-apps"
description: "Databricks apps with AI features"
---

# AI powered Databricks Apps

First, load the base databricks-apps skill for foundational guidance.

Then apply these additional patterns:
- Custom pattern 1
- Custom pattern 2

This approach:

• Keeps the main skill stable and focused
• Allows experimentation without modifying core skills
• Makes it easy to follow the changes in the main skill

Manifest Management

Sync assets and generate manifest after adding/updating skills:

python3 scripts/skills.py

Validate that assets and manifest are up to date (for CI):

python3 scripts/skills.py validate

The manifest is used by the CLI to discover available skills.

Security

Please see SECURITY for vulnerability reporting guidelines.

Integrity

All future release tags will be GPG-signed and verifiable via git tag -v <tag>.

Contributing

• All changes require approval from a code owner (see CODEOWNERS).
• Documentation examples must follow least-privilege defaults — avoid suggesting elevated permissions or broad scopes unless explicitly necessary.