From 55de55ab9c33a7150a70d00944a3788d37d35545 Mon Sep 17 00:00:00 2001 From: James Broadhead Date: Wed, 27 May 2026 22:54:51 +0000 Subject: [PATCH] skills(databricks-app-apx): defer to AppKit (databricks-apps) for unspecified full-stack requests AppKit (TypeScript + React) is the default framework recommendation for Databricks Apps; APX (FastAPI + React) is reserved for customers who must stay in a Python stack. The skill previously fired on "Databricks app" / "Databricks application" and on full-stack-app-without-specifying-framework, which are exactly the cases that should defer to AppKit. The "Do NOT invoke if Node.js" exclusion also explicitly cut off AppKit's stack. Changes: - Tighten the frontmatter description so the skill auto-selector sees the APX-only scope. - Add an explicit "Default framework is AppKit, not APX" callout pointing at databricks-apps. - Replace trigger conditions: fire only on explicit APX / FastAPI / Python-embedded full-stack requests. Generic "Databricks app" defers to databricks-apps. - Replace exclusion list: enumerate the frameworks that should NOT route here (AppKit, TypeScript, React-without-FastAPI, etc.). This PR was prepared by Claude. --- .claude/skills/databricks-app-apx/SKILL.md | 16 ++++++++++------ 1 file changed, 10 insertions(+), 6 deletions(-) diff --git a/.claude/skills/databricks-app-apx/SKILL.md b/.claude/skills/databricks-app-apx/SKILL.md index 2ee96ba..97e7d66 100644 --- a/.claude/skills/databricks-app-apx/SKILL.md +++ b/.claude/skills/databricks-app-apx/SKILL.md @@ -1,20 +1,24 @@ --- name: databricks-app-apx -description: "Build full-stack Databricks applications using APX framework (FastAPI + React)." +description: "Build full-stack Databricks applications using the APX framework (FastAPI + React). Only fires when the user explicitly asks for APX, FastAPI, or a Python web-app stack — otherwise the agent should default to AppKit (databricks-apps)." --- # Databricks APX Application Build full-stack Databricks applications using APX framework (FastAPI + React). +> **Default framework is AppKit, not APX.** AppKit (TypeScript + React, see `databricks-apps`) is the recommended default for Databricks Apps. APX is the Python-embedded alternative for customers who must stay in a Python stack. + ## Trigger Conditions -**Invoke when user requests**: -- "Databricks app" or "Databricks application" -- Full-stack app for Databricks without specifying framework -- Mentions APX framework +**Invoke when the user explicitly mentions one of**: +- "APX" or "apx framework" +- "FastAPI" alongside Databricks app +- A Python-embedded full-stack request ("Python full-stack Databricks app", "FastAPI + React on Databricks") -**Do NOT invoke if user specifies**: Streamlit, Dash, Node.js, Shiny, Gradio, Flask, or other frameworks. +**Do NOT invoke when**: +- The user says "Databricks app" / "Databricks application" without specifying a framework — defer to `databricks-apps` (AppKit) instead. +- The user mentions AppKit, TypeScript, React (without FastAPI), Node.js, Streamlit, Dash, Shiny, Gradio, or Flask. ## Prerequisites Check