skills.rest
9vantage
9vantageCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

powerbi-report-authoring

Create and edit Power BI report files in PBIR/PBIP format using authoring CLIs.

Updated Jul 14, 2026
Search Tags:#data visualization#validation#cli#power bi#pbir#pbip#report authoring
One-click install
npx skills add https://github.com/9vantage/skills-for-fabric-clone --skill powerbi-report-authoring-9vantage
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: powerbi-report-authoring
Source: https://github.com/9vantage/skills-for-fabric-clone/tree/main/plugins/powerbi-authoring/skills/powerbi-report-authoring
Command: npx skills add https://github.com/9vantage/skills-for-fabric-clone --skill powerbi-report-authoring-9vantage

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @microsoft/powerbi-report-authoring-cli, @microsoft/powerbi-desktop-bridge-cli, and includes references (resource) components.

What problem does it solve? Editing Power BI report definitions in PBIR/PBIP format requires precise JSON structures, role bindings, and formatting properties that are easy to get wrong from memory, causing validation failures and broken rendering in Power BI Desktop. ## Core Features & Use Cases - PBIR File Authoring: Add and modify pages, visuals, filters, slicers, bookmarks, themes, and formatting using the powerbi-report-author CLI as the source of truth for roles, properties, and enum values. - Validation and Render Verification: Validate PBIR after every change batch and verify rendered output through the powerbi-desktop CLI reload and screenshot loop. - Use Case: Given an approved report design brief, implement a multi-page PBIP report with KPI cards, clustered bar charts, and slicers, then validate the .Report directory and capture Desktop screenshots to confirm each page renders correctly. ## Quick Start Ask the AI to implement the approved report spec by adding a new page with a card visual and a bar chart to your PBIP project, then validate and screenshot the result.

Frequently Asked Questions about powerbi-report-authoring

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

FAQPage Schema
How do I add a visual to a Power BI PBIP report?▼

Create a visual.json file under definition/pages/<pageName>/visuals/<visualName>/ with a unique 20-hex-character name, position, visualType, and query projections inside queryState. Confirm exact role names with powerbi-report-author catalog describe before writing bindings.

How do I validate PBIR report files before opening Power BI Desktop?▼

Run powerbi-report-author validate against the .Report directory after every logical batch of edits. It checks JSON schema, structure, IDs, formatting properties, enum values, and layout bounds; fix all errors before reloading Desktop.

What is the difference between PBIR and PBIP in Power BI?▼

PBIP is the Power BI Project format containing the .pbip manifest, a .Report folder, and a .SemanticModel folder. PBIR is the report definition format inside the .Report folder, holding report.json, pages, and per-visual JSON files.

Why does my Power BI card visual render empty after editing JSON?▼

A common cause is using the legacy Fields role instead of Data in the cardVisual queryState, which Desktop cannot resolve. Verify role names with powerbi-report-author catalog describe cardVisual and revalidate the report.

Can I verify Power BI report rendering without opening Desktop manually?▼

Yes, the powerbi-desktop CLI can open a PBIP, reload the current report files by PID, and capture per-page or all-page screenshots. Run reload and screenshot serially per PID and review screenshots before reporting completion.

Related Skills

Explore More Data & Analytics Skills→
microsoftmicrosoft
952

powerbi-report-planning

Coordinate Power BI report planning and approval workflows into a locked spec.

Official
Advanced
rritecrritec
3

powerbi-report-management

Manage Power BI report items in Microsoft Fabric workspaces via the Fabric REST API.

Community
Advanced
InsightfulAnalyticsInsightfulAnalytics
6

tmdl

Author and edit TMDL files for Power BI semantic models in PBIP projects.

Community
Advanced
InsightfulAnalyticsInsightfulAnalytics
6

pbir-cli

Create, format, validate, and publish Power BI reports through the pbir CLI.

Community
Advanced