pbip-workflow

Manages git version control for Power BI Project files with TMDL and PBIR text formats.

2|Updated Jun 22, 2026
One-click install
npx skills add https://github.com/Kemetra/Seshat-BI --skill pbip-workflow-kemetra
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: pbip-workflow
Source: https://github.com/Kemetra/Seshat-BI/tree/main/.claude/skills/pbip-workflow
Command: npx skills add https://github.com/Kemetra/Seshat-BI --skill pbip-workflow-kemetra

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Power BI's default .pbix format is a binary zip that cannot be diffed, merged, or reviewed in git, making it impossible to track who changed a DAX measure or why. This Skill guides teams through adopting the Power BI Project (PBIP) format so semantic models and reports become reviewable plain-text code. ## Core Features & Use Cases - PBIP Adoption & Assessment: Run governed, read-only intake of an existing PBIP project with seshat adopt-pbip assess, then scaffold an adoption record only after explicitly accepting the assessment digest. - Commit vs. Ignore Rules: Apply Microsoft's official .gitignore baseline so TMDL model definitions are tracked while localSettings.json and cache.abf stay out of version control. - Windows & Diff Troubleshooting: Resolve 260-character path limits, CRLF line-ending noise, UTF-8 BOM corruption, and stale Power BI Desktop sessions that hide external edits. - Use Case: A teammate opens a pull request changing the Gross Margin measure. Because the measure lives in TMDL text, you review it like code—checking for DIVIDE() usage, duplicated logic, and bidirectional relationships—before merging. ## Quick Start Ask the assistant to assess an existing Power BI Project directory for git adoption and explain which files should be committed or ignored.

Frequently Asked Questions about pbip-workflow

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I put a Power BI report under git version control?▼

Save the report as a Power BI Project (.pbip) instead of .pbix. PBIP stores the semantic model as TMDL text and the report as PBIR, so tables, relationships, and DAX measures become diffable and reviewable in pull requests.

PBIP vs .pbix: which format should I use for Power BI?▼

Use PBIP when you need version control, code review, and collaboration, since it saves the model and report as plain text. Keep .pbix only for simple single-author sharing; you can convert between the two via Power BI Desktop's Save As.

Why is Save as Power BI Project missing in Power BI Desktop?▼

PBIP is a preview feature that must be enabled manually. Go to File > Options and settings > Options > Preview features, check the Power BI Project (.pbip) save option, then use File > Save as > Power BI Project.

Which PBIP files should I commit or ignore in git?▼

Commit everything under *.SemanticModel/definition/ and *.Report/definition/, plus .platform and the .pbip file. Ignore only **/.pbi/localSettings.json and **/.pbi/cache.abf per Microsoft's official baseline, and verify with git check-ignore.

Why do my Power BI PBIP diffs look noisy or saves fail on Windows?▼

Noisy diffs come from CRLF line endings—set git config core.autocrlf true and add a .gitattributes file. Save failures usually come from the 260-character path limit, so keep the repo at a short root path and use short table names.

Why does Power BI Desktop show old content after I edited TMDL externally?▼

Desktop serves its in-memory session and restores cached view state from .pbi/localSettings.json. Quit Desktop fully, move localSettings.json aside for both .Report and .SemanticModel, then reopen via File Explorer rather than the Recent list.