pbip

Guides Power BI Project (PBIP) structure, PBIX extraction, and cross-cutting rename operations.

6|3|Updated Jul 4, 2026
One-click install
npx skills add https://github.com/InsightfulAnalytics/PBI_Agentic_Dev --skill pbip-insightfulanalytics
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: pbip
Source: https://github.com/InsightfulAnalytics/PBI_Agentic_Dev/tree/main/plugins/pbip/skills/pbip
Command: npx skills add https://github.com/InsightfulAnalytics/PBI_Agentic_Dev --skill pbip-insightfulanalytics

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Power BI Project files decompose reports and semantic models into many interlinked text files, and operations like renaming a table or forking a project silently break references scattered across TMDL, visual JSON, bookmarks, and DAX query files. This Skill provides the structural knowledge and validation tooling to navigate, convert, and safely modify PBIP projects without corrupting them. ## Core Features & Use Cases - Project Structure Guidance: Explains every PBIP file type (.pbip, .pbir, .pbism, .platform, .pbi/ runtime state), thick vs thin reports, and PBIX vs PBIP trade-offs. - PBIX Extraction and Conversion: Extracts PBIX ZIP archives with correct per-file encoding handling and assembles a PBIP from an extracted thin PBIX. - Rename Cascade Reference: Documents every location that must be updated when renaming tables, measures, or columns, including sparkline metadata, bookmark filters, and culture files. - Automated Validation: Ships a validate_pbip.py script that checks .platform identity, datasetReference resolution, orphan page folders, page-name regex rules, and theme resource resolution, delegating deep report checks to pbir validate. - Use Case: After renaming a table from Customers to Customer, run the validator and the provided grep patterns to confirm no stale references remain in visual JSONs, filters, or DAX queries before reopening Power BI Desktop. ## Quick Start Ask the agent to validate your PBIP project folder and explain its structure, for example by requesting a check of all cross-file references after renaming a table in your Power BI project.

Frequently Asked Questions about pbip

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

FAQPage Schema
How do I convert a PBIX file to PBIP format?▼

The standard path is File > Save As in Power BI Desktop, choosing the PBIP format. For thin PBIX files with modern PBIR content, you can also extract the ZIP archive and manually assemble a PBIP folder with a .pbip file, definition.pbir using byConnection, and a .platform file.

What is the difference between PBIX and PBIP?▼

PBIX is a single binary file that cannot be diffed or edited externally, while PBIP decomposes the same content into human-readable text files organized in folders. PBIP enables Git source control, multi-author collaboration, and external editing in VS Code or Tabular Editor.

How do I rename a table in a PBIP project without breaking visuals?▼

Renaming requires updating the TMDL file name, table declaration, partitions, relationships, DAX expressions, visual JSON Entity and queryRef fields, filter configs, bookmarks, sparkline metadata, report extensions, culture files, and DAX query files. The rename-cascade reference documents each location with before and after examples.

Why did my renamed page folder disappear from Power BI Desktop?▼

Page folder names must match the regex ^[\w-]+$ containing only word characters or hyphens. Names with spaces, dots, or other punctuation are silently ignored by Power BI Desktop with no error dialog, and the folder name must exactly match the name field in page.json.

What is the difference between thick and thin Power BI reports?▼

A thick report bundles the .Report and .SemanticModel folders together with definition.pbir using byPath, while a thin report contains only .Report and connects to a remote semantic model via byConnection. Thin reports are preferred for managed or shared BI scenarios.

Can I validate a PBIP project from the command line?▼

Yes, run python3 scripts/validate_pbip.py against the .pbip file or project root to check .platform identity, datasetReference resolution, orphan pages, and theme resources. It delegates deep .Report schema validation to pbir validate when that CLI is on PATH.