powerbi-report

Skill: Inspect and Modify Report Layout

Trigger

Activate when the user asks about report pages, report structure, visuals, bookmarks, or wants to add a new page. Works against unpacked PBIR folders (.Report/) — does not require a Power BI Desktop connection.

Commands

# Show the full report structure: pages, visuals, bookmarks
pbi-agent report info

# Explicitly point at a .pbip / .Report path (auto-detected from CWD if omitted)
pbi-agent report info path/to/MyReport.Report

# List pages only
pbi-agent report pages

# Add a new page
pbi-agent report add-page "Executive Summary"
pbi-agent report add-page "Regional Deep Dive" path/to/MyReport.Report

Guidance

• The PBIX_PATH argument is optional. When omitted, powerbi-agent searches the current working directory for a .Report folder.
• Page names become folder names on disk — avoid special characters (slashes, colons) that would break filesystem paths.
• After adding a page, reload it in Power BI Desktop via pbi-cli's pbi report reload (if available) or reopen the project.

Schema Rules (Don't Break These)

These constraints are not obvious but will silently crash PBI Desktop on open:

.pbip artifacts — only report is allowed

The .pbip file's artifacts array must contain ONLY a report entry. Never add a dataset entry — the schema rejects it:

// CORRECT
"artifacts": [{ "report": { "path": "MyReport.Report" } }]

// WRONG — crashes on open with a schema validation error
"artifacts": [
  { "report": { "path": "MyReport.Report" } },
  { "dataset": { "path": "MyModel.SemanticModel" } }
]

The semantic model is linked via definition.pbir, not the .pbip artifacts.

definition.pbir path — must be a non-null string

datasetReference.byPath.path must always be a non-null string pointing to the SemanticModel folder. Setting it to null is a schema violation:

// CORRECT
"datasetReference": { "byPath": { "path": "../MyModel.SemanticModel" } }

// WRONG — null is not allowed by the schema
"datasetReference": { "byPath": { "path": null } }