Skip to content

experimental: add databricks-lakeflow-connect skill - #1

Closed
jralfonsog wants to merge 1 commit into
mainfrom
experimental/lakeflow-connect
Closed

experimental: add databricks-lakeflow-connect skill#1
jralfonsog wants to merge 1 commit into
mainfrom
experimental/lakeflow-connect

Conversation

@jralfonsog

@jralfonsog jralfonsog commented May 27, 2026

Copy link
Copy Markdown
Owner

Summary

New experimental skill databricks-lakeflow-connect for managed ingestion pipelines (Salesforce, Workday Reports, ServiceNow, Google Analytics 4, HubSpot, Confluence, SQL Server cloud + on-prem, plus Public Preview database / file connectors).

Marked as draft for scope-first review. GA-first deep coverage; PuPr connectors are listed in SKILL.md as production-supported but their deep coverage will land in follow-up commits. No databricks-pipelines overlap — Lakeflow Connect pipelines reuse the pipelines API surface via ingestion_definition, and this skill cross-links to skills/databricks-pipelines/ from the decision tree and Related Skills.

Changes

  • experimental/databricks-lakeflow-connect/SKILL.md (~200 lines) — routing + 3-tier catalog (GA / PuPr / Beta-PrPr) + workflow + key concepts + common issues.
  • experimental/databricks-lakeflow-connect/references/4-ingestion-decision-tree.md (~130 lines) — Lakeflow Connect vs Auto Loader vs Lakehouse Federation vs Delta Sharing vs Zerobus + cost considerations + escape hatches. Cross-links to the Auto Loader work in databricks-solutions/ai-dev-kit#539.
  • experimental/databricks-lakeflow-connect/agents/openai.yaml + assets/databricks.{svg,png} — auto-generated via scripts/skills.py generate.
  • manifest.json — updated by scripts/skills.py generate to register the new skill.

SharePoint / Google Drive (Beta as of May 2026; GA target Jun 1) are not first-class in v1 — they appear in the Beta/PrPr note in SKILL.md. databricks-zerobus-ingest is pointed to from the catalog and decision tree (push-vs-pull dichotomy), not re-covered.

To follow

Commit Content
2 references/1-saas-connectors.md — 6 GA SaaS connectors deep coverage
3 references/2-database-connectors.md — SQL Server cloud + on-prem + gateway pattern
4 references/5-troubleshooting-and-monitoring.md — GA-focused issues + event log queries
(v2) PuPr deep coverage (NetSuite, Dynamics 365, PG/MySQL CDC, SFTP, query-based databases, Foreign Catalog query) as connectors stabilize
(v2) references/3-file-and-streaming-connectors.md — created when SFTP + SharePoint/Drive get deep coverage

Cross-repo

  • Tracking issue: databricks-solutions/ai-dev-kit#499.
  • Companion ai-dev-kit PR: databricks-solutions/ai-dev-kit#539 ships the Auto Loader reference in the SDP skill that this skill's decision tree cross-links to.
  • Scope-checked in #ai-dev-kit-team Slack on 2026-05-27; maintainers signed off on Databricks Agent Skills experimental/ as the destination.

Test plan

  • python3 scripts/skills.py generate clean.
  • python3 scripts/skills.py validate passes (Everything is up to date.).
  • All cross-skill links resolve against the DAS layout (skills/databricks-pipelines/, skills/databricks-dabs/, skills/databricks-jobs/, experimental/databricks-zerobus-ingest/, experimental/databricks-unity-catalog/).
  • stf audit (L3 doc quality) — overall 8.2/10 (PASS all dimensions). Per-dimension scores below.
  • CI green.
  • Full Skillforge orchestration per databricks-field-eng/skillforge/SKILL.md after references/1-saas-connectors.md lands (L1 link validity will be clean once the deferred references ship).
  • Skillforge L4/L5 with ground_truth.yaml before promoting out of draft.
  • Reviewer directional feedback on scope before continuing with follow-up commits.

stf audit per-dimension (L3)

Dimension Score Status
tool_accuracy 10.0 PASS
examples_valid 10.0 PASS
no_conflicts 9.0 PASS
llm_navigable 9.0 PASS
scoped_clearly 9.0 PASS
security 8.0 PASS
actionable_instructions 7.0 PASS
error_handling 7.0 PASS
no_hallucination_triggers 7.0 PASS
self_contained 6.0 PASS (reflects the 3 deferred references; expected to rise as follow-up commits land)

This pull request was AI-assisted by Isaac.

Initial scope-first commit for a draft PR. GA-first deep coverage,
PuPr listed but deferred to follow-up commits.

This commit includes:
- SKILL.md (routing + 3-tier catalog: GA / PuPr / Beta-PrPr + workflow
  + key concepts + common issues)
- references/4-ingestion-decision-tree.md (LFC vs Auto Loader vs
  Lakehouse Federation vs Delta Sharing vs Zerobus + cost
  considerations + escape hatches)
- agents/openai.yaml + assets/ via scripts/skills.py generate
- manifest.json updated

To follow in subsequent commits:
- references/1-saas-connectors.md (Salesforce, Workday Reports,
  ServiceNow, GA4, HubSpot, Confluence — all GA)
- references/2-database-connectors.md (SQL Server cloud + on-prem +
  gateway pattern intro — GA)
- references/5-troubleshooting-and-monitoring.md (GA-focused)

Public Preview connectors (NetSuite, Dynamics 365, PG/MySQL CDC,
query-based databases, Foreign Catalog query-based, SFTP) are
production-supported and listed in SKILL.md; deep coverage will be
added incrementally as PuPr connectors stabilize. SharePoint/Google
Drive (Beta currently, GA Jun 1 target) and other Beta/PrPr connectors
are not first-class in this skill.

references/3-file-and-streaming-connectors.md will be created when SFTP
+ SharePoint/Drive get deep coverage (post-v1).

Signed-off-by: Jose Alfonso <jralfonsog@gmail.com>
@jralfonsog

Copy link
Copy Markdown
Owner Author

Superseded by upstream PR databricks#103

@jralfonsog jralfonsog closed this May 27, 2026
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