Skip to content

Add databricks-powerbi-migration skill#196

Open
jjaiwant328 wants to merge 1 commit intodatabricks-solutions:mainfrom
jjaiwant328:add-powerbi-migration-skill
Open

Add databricks-powerbi-migration skill#196
jjaiwant328 wants to merge 1 commit intodatabricks-solutions:mainfrom
jjaiwant328:add-powerbi-migration-skill

Conversation

@jjaiwant328
Copy link

@jjaiwant328 jjaiwant328 commented Mar 1, 2026

Summary

  • Adds databricks-powerbi-migration skill for migrating Power BI semantic models to Databricks metric views
  • Restructured with progressive disclosure pattern (matching SDP skill): concise SKILL.md (164 lines) + 9 numbered guide files for detailed per-phase instructions
  • 16-step guided workflow covering: input scanning, PBI model parsing, catalog validation, schema extraction, mapping layer construction, ERD/domain generation, KPI definitions, data discovery, query optimization, existing metric view detection, metric view creation, report analysis, and deployment checklist generation
  • Includes 6 Python/Bash utility scripts for automated parsing, comparison, and scaffolding
  • Supports all PBI model formats (.pbit, .pbix, .bim, TMDL, JSON) via content-based detection
  • Handles 4 migration scenarios (direct repoint, view layer, mapping document, intermediate mapping)
  • Supports parallel catalog probing via shell subagents and batched SQL via execute_sql_multi

Files Added

  • databricks-skills/databricks-powerbi-migration/SKILL.md -- main skill entry point (164 lines, progressive disclosure)
  • databricks-skills/databricks-powerbi-migration/1-input-scanning.md through 9-subagent-patterns.md -- 9 detailed guide files
  • databricks-skills/databricks-powerbi-migration/REFERENCE.md -- detailed patterns for 15 identified gaps
  • databricks-skills/databricks-powerbi-migration/EXAMPLES.md -- input/output examples
  • databricks-skills/databricks-powerbi-migration/README.md -- usage overview and script documentation
  • databricks-skills/databricks-powerbi-migration/approach.md -- high-level methodology
  • databricks-skills/databricks-powerbi-migration/scripts/ -- 6 utility scripts

Files Modified

  • databricks-skills/install_skills.sh -- registered new skill in DATABRICKS_SKILLS, get_skill_description, get_skill_extra_files (including all numbered guides)
  • databricks-skills/README.md -- added skill to Analytics & Dashboards section

Test plan

  • Installed locally via install_skills.sh --local databricks-powerbi-migration
  • Verified skill loads in Claude Code via /databricks-powerbi-migration
  • Verified description-based routing triggers on Power BI migration prompts
  • SKILL.md under 500 lines (164 lines)
  • All paths use forward slashes and are portable (no hardcoded absolute paths)
  • No credentials or secrets in any file
  • Passed Databricks pre-commit and pre-push secret scanning hooks

@malcolndandaro
Copy link
Collaborator

I like the idea and think it looks great, but I'm requesting a review from @calreynolds or @dustinvannoy-db, as it's entirely new and we don't have migration skills right now.

Copy link
Collaborator

@calreynolds calreynolds left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We will get back to you! We're debating whether we want to include anything third-party or not

My content feedback would be: I think we can trim this generally!

Also, can you adjust the file structures to be similar to how we do spark-declarative-pipelines? The more uniform, the easier for the llm to digest

@jjaiwant328
Copy link
Author

Thank you for the feedback. Will follow up on this and let you know when I am done. Also it is more of a PowerBI to Databricks migration, but because of the naming convention it is confusing. Let me know if you want me to change it.

Restructured with progressive disclosure pattern (matching SDP skill):
- SKILL.md (164 lines) as entry point with 16-step checklist
- 9 numbered guide files for detailed instructions per workflow phase
- REFERENCE.md, EXAMPLES.md, approach.md for supplementary patterns
- 6 Python/Bash utility scripts for parsing, comparison, and scaffolding
- README.md with usage overview and script documentation

Supports all PBI model formats via content-based detection, 4 migration
scenarios, parallel catalog probing via subagents, and existing metric
view detection before creating new ones.
@jjaiwant328 jjaiwant328 force-pushed the add-powerbi-migration-skill branch from ceea803 to d8d34b9 Compare March 4, 2026 16:26
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.

3 participants