power-bi-agent-skills: Skill for Claude Code

PBIP Project Skill

This skill helps create and manage Power BI Desktop Project (PBIP) structure for source control-friendly Power BI development.

When to Use This Skill

• Starting a new Power BI project from scratch
• Converting an existing concept into a PBIP structure
• Setting up the folder structure for semantic models and reports
• Creating pointer files (.pbip, .pbism, .pbir)
• Configuring project-level settings

PBIP Project Structure

A complete PBIP project has this structure:

<ProjectName>.pbip                    # Project pointer file
├── <ProjectName>.SemanticModel/      # Semantic model folder
│   ├── definition.pbism              # Semantic model pointer
│   ├── model.bim                     # Model metadata (auto-generated)
│   └── definition/                   # TMDL files
│       ├── database.tmdl
│       ├── model.tmdl
│       ├── relationships.tmdl
│       ├── tables/
│       │   └── <TableName>.tmdl
│       └── expressions.tmdl
├── <ProjectName>.Report/             # Report folder
│   ├── definition.pbir               # Report pointer
│   ├── report.json                   # Report configuration
│   └── definition/                   # Report definition files
│       ├── pages/
│       │   └── <PageId>/
│       │       └── page.json
│       └── ...
└── .pbi/                             # Local settings (gitignored)
    └── localSettings.json

Creating a New PBIP Project

Step 1: Create the Project Pointer File

Create <ProjectName>.pbip:

{
  "version": "1.0",
  "artifacts": [
    {
      "report": {
        "path": "<ProjectName>.Report"
      }
    }
  ],
  "settings": {
    "enableAutoRecovery": true
  }
}

Step 2: Create the Semantic Model Folder

Create <ProjectName>.SemanticModel/definition.pbism:

{
  "version": "1.0",
  "datasetReference": {
    "byPath": null,
    "byConnection": null
  }
}

Step 3: Create Core TMDL Files

Create <ProjectName>.SemanticModel/definition/database.tmdl: