Skip to content

skills: bundle databricks-apps (AppKit) + databricks-core from databricks-agent-skills#164

Open
jamesbroadhead wants to merge 1 commit into
datasciencemonkey:mainfrom
jamesbroadhead:jb/bundle-databricks-apps-skill
Open

skills: bundle databricks-apps (AppKit) + databricks-core from databricks-agent-skills#164
jamesbroadhead wants to merge 1 commit into
datasciencemonkey:mainfrom
jamesbroadhead:jb/bundle-databricks-apps-skill

Conversation

@jamesbroadhead
Copy link
Copy Markdown

@jamesbroadhead jamesbroadhead commented May 27, 2026

Summary

Vendors two skills from databricks/databricks-agent-skills (DAS) into .claude/skills/:

  • databricks-apps — the canonical AppKit (TypeScript + React) skill. 19 files, including a 9-file references/appkit/ directory (frontend, tRPC, SQL queries, Lakebase, model serving, jobs, proto-first, proto-contracts, Genie, AppKit SDK, files).
  • databricks-coredatabricks-apps declares parent: databricks-core so its inheritance works correctly only when the parent is also present. 26 files.

Why

CODA bundles 43 skills today, but none cover AppKit (grep -i appkit .claude/skills/**/* returns no hits). AppKit is the recommended default framework for Databricks Apps, so the agent today has no AppKit-aware skill to route generic "build a Databricks app" requests to.

This also unblocks the sibling PR #162 (databricks-app-apx defers to AppKit) — that PR asks the apx skill to defer to databricks-apps, which only works once databricks-apps actually exists in this repo.

Caveats

  • databricks-core overlaps with CODA's existing narrower databricks-config skill (auth/profile content). Keeping both is intentional — the agent picks the better fit per query. A future pass can fold them if drift becomes a problem.
  • Skill descriptions and trigger phrasings come from DAS verbatim; tuning them for CODA's audience is out of scope for this bundle PR.

Source

skills/databricks-apps and skills/databricks-core in databricks/databricks-agent-skills @ origin/main (a6da289).

Test plan

  • All 45 files copy cleanly (git diff --cached --stat shows the right shape).
  • Manual smoke: in CODA shell, ask "build a Databricks app" and confirm the agent loads databricks-apps (AppKit) rather than databricks-app-apx.

This pull request and its description were written by Claude.

…bricks-agent-skills

CODA bundles 43 skills today but none cover AppKit. AppKit is the
canonical TypeScript + React stack for Databricks Apps and lives in
the stable `databricks-apps` skill in databricks/databricks-agent-skills.
Without it, the agent has no AppKit-aware skill to route generic
"build a Databricks app" requests to, and the sibling PR that asks
`databricks-app-apx` to defer to AppKit has nothing to defer *to*.

Vendors the two skills verbatim:

- `.claude/skills/databricks-apps/` — 19 files (SKILL.md,
  agents/openai.yaml, assets/, references/ including the 9-file
  `appkit/` subdirectory).
- `.claude/skills/databricks-core/` — 26 files. databricks-apps
  declares `parent: databricks-core`; bundling the parent so
  inheritance works. CODA already has a narrower `databricks-config`
  skill that overlaps with databricks-core's auth/profile content;
  keeping both is intentional — let the agent pick the better fit
  per query.

Source: skills/databricks-apps and skills/databricks-core in
databricks/databricks-agent-skills @ origin/main (a6da289).

This PR was prepared by Claude.
@jamesbroadhead jamesbroadhead force-pushed the jb/bundle-databricks-apps-skill branch from 6560e02 to 62bc647 Compare May 28, 2026 09:33
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant