Move skill-authoring into databricks-skills/ per review feedback

Reviewer asked to move the skill into .claude/ where developer skills
live. Since .claude/ is gitignored (it's the install target), the
correct home is databricks-skills/ alongside all other skills, with
install_skills.sh handling the copy to .claude/skills/.

- Move .skill-authoring/ → databricks-skills/skill-authoring/
- Delete install_skill_authoring.sh (install_skills.sh handles it now)
- Register in install_skills.sh, install.sh, install.ps1
- Add to CORE_SKILLS (always installed for contributors)
- Update path references in CONTRIBUTING.md and README.md
- Add to skills table in databricks-skills/README.md

Co-authored-by: Isaac

Author: praneeth_paikray-data

.skill-authoring/install_skill_authoring.sh

@@ -92,7 +92,7 @@ Ensure your changes work with a live Databricks workspace.
 
 ### Recommended: Use the Authoring Skill
 
-The fastest way to create a high-quality skill is with the `skill-authoring` skill (available in `.skill-authoring/` when you clone the repo). Ask Claude:
+The fastest way to create a high-quality skill is with the `skill-authoring` skill (available in `databricks-skills/skill-authoring/`). Ask Claude:
 
 > "Help me create a new skill for [Databricks feature]"
 
@@ -154,8 +154,8 @@ Before submitting a PR for a new skill, verify:
 ### Skill Format Reference
 
 For detailed format specifications, see:
-- `.skill-authoring/references/skill-format.md` — Frontmatter rules, progressive disclosure, section conventions
-- `.skill-authoring/references/test-format.md` — ground_truth.yaml and manifest.yaml schemas
+- `databricks-skills/skill-authoring/references/skill-format.md` — Frontmatter rules, progressive disclosure, section conventions
+- `databricks-skills/skill-authoring/references/test-format.md` — ground_truth.yaml and manifest.yaml schemas
 
 ### Evaluation & Optimization
 

CONTRIBUTING.md

@@ -110,6 +110,9 @@ cp -r ai-dev-kit/databricks-skills/databricks-agent-bricks .claude/skills/
 ### 📚 Reference
 - **databricks-docs** - Documentation index via llms.txt
 
+### 🛠️ Contributing
+- **skill-authoring** - Guided workflow for creating new Databricks skills for ai-dev-kit
+
 ## How It Works
 
 ```
@@ -155,7 +158,7 @@ For contributors creating new skills, ai-dev-kit provides a guided authoring wor
 
 ### Quick Start (Contributors)
 
-1. **Use the authoring skill** — Clone the repo and ask Claude: "Help me create a new skill for [feature]". The `skill-authoring` skill (in `.skill-authoring/`) will guide you through the full workflow: interview, draft, test, validate, register.
+1. **Use the authoring skill** — Clone the repo and ask Claude: "Help me create a new skill for [feature]". The `skill-authoring` skill (in `databricks-skills/skill-authoring/`) will guide you through the full workflow: interview, draft, test, validate, register.
 
 2. **Or start manually** — Copy the template and fill in the sections:
    ```bash

databricks-skills/README.md

@@ -47,7 +47,7 @@ MLFLOW_REPO_RAW_URL="https://raw.githubusercontent.com/mlflow/skills"
 MLFLOW_REPO_REF="main"
 
 # Databricks skills (hosted in this repo)
-DATABRICKS_SKILLS="databricks-agent-bricks databricks-ai-functions databricks-aibi-dashboards databricks-bundles databricks-app-python databricks-config databricks-dbsql databricks-docs databricks-genie databricks-iceberg databricks-jobs databricks-lakebase-autoscale databricks-lakebase-provisioned databricks-metric-views databricks-mlflow-evaluation databricks-model-serving databricks-python-sdk databricks-execution-compute databricks-spark-declarative-pipelines databricks-spark-structured-streaming databricks-synthetic-data-gen databricks-unity-catalog databricks-unstructured-pdf-generation databricks-vector-search databricks-zerobus-ingest spark-python-data-source"
+DATABRICKS_SKILLS="databricks-agent-bricks databricks-ai-functions databricks-aibi-dashboards databricks-bundles databricks-app-python databricks-config databricks-dbsql databricks-docs databricks-genie databricks-iceberg databricks-jobs databricks-lakebase-autoscale databricks-lakebase-provisioned databricks-metric-views databricks-mlflow-evaluation databricks-model-serving databricks-python-sdk databricks-execution-compute databricks-spark-declarative-pipelines databricks-spark-structured-streaming databricks-synthetic-data-gen databricks-unity-catalog databricks-unstructured-pdf-generation databricks-vector-search databricks-zerobus-ingest skill-authoring spark-python-data-source"
 
 # MLflow skills (fetched from mlflow/skills repo)
 MLFLOW_SKILLS="agent-evaluation analyze-mlflow-chat-session analyze-mlflow-trace instrumenting-with-mlflow-tracing mlflow-onboarding querying-mlflow-metrics retrieving-mlflow-traces searching-mlflow-docs"
@@ -94,6 +94,7 @@ get_skill_description() {
         "databricks-unstructured-pdf-generation") echo "Generate synthetic PDFs for RAG" ;;
         "databricks-vector-search") echo "Vector Search - endpoints, indexes, and queries for RAG" ;;
         "databricks-zerobus-ingest") echo "Zerobus Ingest - gRPC data ingestion into Delta tables" ;;
+        "skill-authoring") echo "Guided workflow for creating new Databricks skills for ai-dev-kit" ;;
         # MLflow skills (from mlflow/skills repo)
         "agent-evaluation") echo "End-to-end agent evaluation workflow" ;;
         "analyze-mlflow-chat-session") echo "Debug multi-turn conversations" ;;
@@ -132,6 +133,7 @@ get_skill_extra_files() {
         "databricks-spark-structured-streaming") echo "checkpoint-best-practices.md kafka-streaming.md merge-operations.md multi-sink-writes.md stateful-operations.md stream-static-joins.md stream-stream-joins.md streaming-best-practices.md trigger-and-cost-optimization.md" ;;
         "databricks-vector-search") echo "index-types.md end-to-end-rag.md" ;;
         "databricks-zerobus-ingest") echo "1-setup-and-authentication.md 2-python-client.md 3-multilanguage-clients.md 4-protobuf-schema.md 5-operations-and-limits.md" ;;
+        "skill-authoring") echo "references/skill-format.md references/test-format.md" ;;
         *) echo "" ;;
     esac
 }

databricks-skills/install_skills.sh

@@ -85,7 +85,7 @@ $script:Skills = @(
     "databricks-metric-views", "databricks-mlflow-evaluation", "databricks-model-serving", "databricks-ai-functions",
     "databricks-python-sdk", "databricks-spark-declarative-pipelines", "databricks-spark-structured-streaming",
     "databricks-synthetic-data-gen", "databricks-unity-catalog", "databricks-unstructured-pdf-generation",
-    "databricks-vector-search", "databricks-zerobus-ingest", "spark-python-data-source"
+    "databricks-vector-search", "databricks-zerobus-ingest", "skill-authoring", "spark-python-data-source"
 )
 
 # MLflow skills (fetched from mlflow/skills repo)
@@ -101,7 +101,7 @@ $script:ApxSkills = @("databricks-app-apx")
 $ApxRawUrl = "https://raw.githubusercontent.com/databricks-solutions/apx/main/skills/apx"
 
 # ─── Skill profiles ──────────────────────────────────────────
-$script:CoreSkills = @("databricks-config", "databricks-docs", "databricks-python-sdk", "databricks-unity-catalog")
+$script:CoreSkills = @("databricks-config", "databricks-docs", "databricks-python-sdk", "databricks-unity-catalog", "skill-authoring")
 
 $script:ProfileDataEngineer = @(
     "databricks-spark-declarative-pipelines", "databricks-spark-structured-streaming",
@@ -1100,7 +1100,7 @@ function Invoke-PromptCustomSkills {
 
     Write-Host ""
     Write-Host "  Select individual skills" -ForegroundColor White
-    Write-Host "  Core skills (config, docs, python-sdk, unity-catalog) are always installed" -ForegroundColor DarkGray
+    Write-Host "  Core skills (config, docs, python-sdk, unity-catalog, skill-authoring) are always installed" -ForegroundColor DarkGray
 
     $items = @(
         @{ Label = "Spark Pipelines";      Value = "databricks-spark-declarative-pipelines"; State = ($preselected -contains "databricks-spark-declarative-pipelines"); Hint = "SDP/LDP, CDC, SCD Type 2" }

.skill-authoring/SKILL.md …tabricks-skills/skill-authoring/SKILL.md.skill-authoring/SKILL.md renamed to databricks-skills/skill-authoring/SKILL.md .skill-authoring/SKILL.md renamed to databricks-skills/skill-authoring/SKILL.md

@@ -88,7 +88,7 @@ MIN_SDK_VERSION="0.85.0"
 G='\033[0;32m' Y='\033[1;33m' R='\033[0;31m' BL='\033[0;34m' B='\033[1m' D='\033[2m' N='\033[0m'
 
 # Databricks skills (bundled in repo)
-SKILLS="databricks-agent-bricks databricks-ai-functions databricks-aibi-dashboards databricks-app-python databricks-bundles databricks-config databricks-dbsql databricks-docs databricks-genie databricks-iceberg databricks-jobs databricks-lakebase-autoscale databricks-lakebase-provisioned databricks-metric-views databricks-mlflow-evaluation databricks-model-serving databricks-python-sdk databricks-spark-declarative-pipelines databricks-spark-structured-streaming databricks-synthetic-data-gen databricks-unity-catalog databricks-unstructured-pdf-generation databricks-vector-search databricks-zerobus-ingest spark-python-data-source"
+SKILLS="databricks-agent-bricks databricks-ai-functions databricks-aibi-dashboards databricks-app-python databricks-bundles databricks-config databricks-dbsql databricks-docs databricks-genie databricks-iceberg databricks-jobs databricks-lakebase-autoscale databricks-lakebase-provisioned databricks-metric-views databricks-mlflow-evaluation databricks-model-serving databricks-python-sdk databricks-spark-declarative-pipelines databricks-spark-structured-streaming databricks-synthetic-data-gen databricks-unity-catalog databricks-unstructured-pdf-generation databricks-vector-search databricks-zerobus-ingest skill-authoring spark-python-data-source"
 
 # MLflow skills (fetched from mlflow/skills repo)
 MLFLOW_SKILLS="agent-evaluation analyze-mlflow-chat-session analyze-mlflow-trace instrumenting-with-mlflow-tracing mlflow-onboarding querying-mlflow-metrics retrieving-mlflow-traces searching-mlflow-docs"
@@ -100,7 +100,7 @@ APX_RAW_URL="https://raw.githubusercontent.com/databricks-solutions/apx/main/ski
 
 # ─── Skill profiles ──────────────────────────────────────────
 # Core skills always installed regardless of profile selection
-CORE_SKILLS="databricks-config databricks-docs databricks-python-sdk databricks-unity-catalog"
+CORE_SKILLS="databricks-config databricks-docs databricks-python-sdk databricks-unity-catalog skill-authoring"
 
 # Profile definitions (non-core skills only — core skills are always added)
 PROFILE_DATA_ENGINEER="databricks-spark-declarative-pipelines databricks-spark-structured-streaming databricks-jobs databricks-bundles databricks-dbsql databricks-iceberg databricks-zerobus-ingest spark-python-data-source databricks-metric-views databricks-synthetic-data-gen"
@@ -898,7 +898,7 @@ prompt_custom_skills() {
 
     echo ""
     echo -e "  ${B}Select individual skills${N}"
-    echo -e "  ${D}Core skills (config, docs, python-sdk, unity-catalog) are always installed${N}"
+    echo -e "  ${D}Core skills (config, docs, python-sdk, unity-catalog, skill-authoring) are always installed${N}"
 
     local selected
     selected=$(checkbox_select \