databricks-workspace-sync

Sync local files and directories with a Databricks workspace using the Databricks CLI.

Updated Feb 7, 2026
One-click install
npx skills add https://github.com/rywerth-dbx/claude-databricks-starter --skill databricks-workspace-sync
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: databricks-workspace-sync
Source: https://github.com/rywerth-dbx/claude-databricks-starter/tree/main/.claude/skills/databricks-workspace-sync
Command: npx skills add https://github.com/rywerth-dbx/claude-databricks-starter --skill databricks-workspace-sync

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Syncing code, notebooks, and scripts between local development environments and a Databricks workspace can be tedious, error-prone, and hard to reproduce.

Core Features & Use Cases

  • Upload and download files and directories to/from a Databricks workspace using the Databricks CLI.
  • Support for notebooks (.ipynb), Python scripts (.py), and SQL files with automatic format handling.
  • Use cases include syncing project code, backing up workspace assets, and provisioning consistent environments across teams.

Quick Start

Use this skill to transfer your local project to the Databricks workspace and verify the results in the UI.

Frequently Asked Questions about databricks-workspace-sync

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I sync local files with a Databricks workspace?

To sync local files with a Databricks workspace, use this skill to transfer directories of notebooks, Python scripts, and SQL files via the Databricks CLI. It requires profile configuration and absolute workspace paths to perform safe, repeatable uploads and downloads.

Can I download notebooks and Python scripts from Databricks to my local environment?

Yes, you can download notebooks and Python scripts from Databricks to your local environment. The skill supports bidirectional syncing to pull workspace assets locally, which is useful for project code backups and offline development.

What file formats are supported when syncing code to Databricks?

The supported file formats when syncing code to Databricks include Jupyter notebooks (.ipynb), Python scripts (.py), and SQL files. The skill handles automatic format detection during upload and download transfers.

Do I need the Databricks CLI configured to sync my workspace files?

Yes, you need the Databricks CLI installed and configured with a valid profile to sync workspace files. The skill relies on this CLI to execute project-wide transfers and manage assets across teams safely.

What is the best way to back up Databricks workspace assets locally?

The best way to back up Databricks workspace assets locally is using a bidirectional sync skill that downloads notebooks and scripts via the CLI. This provisions consistent environments and ensures your project code is safely backed up.

How does syncing Databricks notebooks handle absolute workspace paths?

Syncing Databricks notebooks uses absolute workspace paths to ensure safe and repeatable file transfers. This approach prevents ambiguity during project-wide syncing and guarantees assets are uploaded to or downloaded from the correct directories.