Skip to content

Commit 2a24a79

Browse files
committed
Fix Lakebase and Apps skill guidance based on agent conversation analysis
Five agent conversations building Lakebase-backed apps revealed consistent patterns of wasted work. This fixes the root causes in skill documentation: remove wasteful exploratory commands, add missing --version flag, and document default resource names. Co-authored-by: Isaac
1 parent b438413 commit 2a24a79

5 files changed

Lines changed: 12 additions & 7 deletions

File tree

skills/databricks-apps/SKILL.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
name: databricks-apps
33
description: Build apps on Databricks Apps platform. Use when asked to create dashboards, data apps, analytics tools, or visualizations. Invoke BEFORE starting implementation.
4-
compatibility: Requires databricks CLI (>= v0.292.0)
4+
compatibility: Requires databricks CLI (>= v0.294.0)
55
metadata:
66
version: "0.1.1"
77
parent: databricks
@@ -100,6 +100,8 @@ npx @databricks/appkit docs ./docs/plugins/analytics.md # example: specific doc
100100
1. **Get the manifest** (JSON schema describing plugins and their resources):
101101
```bash
102102
databricks apps manifest --profile <PROFILE>
103+
# See plugins available in a specific AppKit version:
104+
databricks apps manifest --version <VERSION> --profile <PROFILE>
103105
# Custom template:
104106
databricks apps manifest --template <GIT_URL> --profile <PROFILE>
105107
```
@@ -118,6 +120,7 @@ npx @databricks/appkit docs ./docs/plugins/analytics.md # example: specific doc
118120
# With custom template:
119121
databricks apps init --template <GIT_URL> --name <NAME> --features ... --set ... --profile <PROFILE>
120122
```
123+
Optionally use `--version <VERSION>` to target a specific AppKit version.
121124
- **Required**: `--name`, `--profile`. Name: ≤26 chars, lowercase letters/numbers/hyphens only. Use `--features` only for **optional** plugins the user wants (plugins with `requiredByTemplate: false` or absent); mandatory plugins must not be listed in `--features`.
122125
- **Resources**: Pass `--set` for every required resource (each field in `resources.required`) for (1) all plugins with `requiredByTemplate: true`, and (2) any optional plugins you added to `--features`. Add `--set` for `resources.optional` only when the user requests them.
123126
- **Discovery**: Use the parent `databricks` skill to resolve IDs (e.g. warehouse: `databricks warehouses list --profile <PROFILE>` or `databricks experimental aitools tools get-default-warehouse --profile <PROFILE>`).

skills/databricks-jobs/SKILL.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
name: databricks-jobs
33
description: Develop and deploy Lakeflow Jobs on Databricks. Use when creating data engineering jobs with notebooks, Python wheels, or SQL tasks. Invoke BEFORE starting implementation.
4-
compatibility: Requires databricks CLI (>= v0.292.0)
4+
compatibility: Requires databricks CLI (>= v0.294.0)
55
metadata:
66
version: "0.1.0"
77
parent: databricks

skills/databricks-lakebase/SKILL.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
name: databricks-lakebase
33
description: "Manage Lakebase Postgres Autoscaling projects, branches, and endpoints via Databricks CLI. Use when asked to create, configure, or manage Lakebase Postgres databases, projects, branches, computes, or endpoints."
4-
compatibility: Requires databricks CLI (>= v0.292.0)
4+
compatibility: Requires databricks CLI (>= v0.294.0)
55
metadata:
66
version: "0.1.0"
77
parent: databricks
@@ -60,6 +60,8 @@ Run `databricks postgres -h` before constructing any command. Run `databricks po
6060

6161
## Create a Project
6262

63+
> **Do NOT list projects before creating.**
64+
6365
```bash
6466
databricks postgres create-project <PROJECT_ID> \
6567
--json '{"spec": {"display_name": "<DISPLAY_NAME>"}}' \
@@ -139,7 +141,7 @@ databricks apps init --name <APP_NAME> \
139141
--features lakebase \
140142
--set "lakebase.postgres.branch=<BRANCH_NAME>" \
141143
--set "lakebase.postgres.database=<DATABASE_NAME>" \
142-
--profile <PROFILE>
144+
--run none --profile <PROFILE>
143145
```
144146

145147
Where `<BRANCH_NAME>` is the full resource name (e.g. `projects/<PROJECT_ID>/branches/<BRANCH_ID>`) and `<DATABASE_NAME>` is the full resource name (e.g. `projects/<PROJECT_ID>/branches/<BRANCH_ID>/databases/<DB_ID>`).

skills/databricks-pipelines/SKILL.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
name: databricks-pipelines
33
description: Develop Lakeflow Spark Declarative Pipelines (formerly Delta Live Tables) on Databricks. Use when building batch or streaming data pipelines with Python or SQL. Invoke BEFORE starting implementation.
4-
compatibility: Requires databricks CLI (>= v0.292.0)
4+
compatibility: Requires databricks CLI (>= v0.294.0)
55
metadata:
66
version: "0.1.0"
77
parent: databricks

skills/databricks/SKILL.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
name: "databricks"
33
description: "Databricks CLI operations: auth, profiles, data exploration, and bundles. Contains up-to-date guidelines for Databricks-related CLI tasks."
4-
compatibility: Requires databricks CLI (>= v0.292.0)
4+
compatibility: Requires databricks CLI (>= v0.294.0)
55
metadata:
66
version: "0.1.0"
77
---
@@ -21,7 +21,7 @@ For specific products, use dedicated skills:
2121
## Prerequisites
2222

2323
1. **CLI installed**: Run `databricks --version` to check.
24-
- **If the CLI is missing or outdated (< v0.292.0): STOP. Do not proceed or work around a missing CLI.**
24+
- **If the CLI is missing or outdated (< v0.294.0): STOP. Do not proceed or work around a missing CLI.**
2525
- **Read the [CLI Installation](databricks-cli-install.md) reference file and follow the instructions to guide the user through installation.**
2626
- Note: In sandboxed environments (Cursor IDE, containers), install commands write outside the workspace and may be blocked. Present the install command to the user and ask them to run it in their own terminal.
2727

0 commit comments

Comments
 (0)