powerbi-report-authoringlisted

> **CRITICAL NOTES** > 1. To find the workspace details (including its ID) from workspace name: list all workspaces and, then, use JMESPath filtering > 2. To find the item details (including its ID) from workspace ID, item type, and item name: list all items of that type in that workspace and, then, use JMESPath filtering # Power BI Report Authoring Skill (PBIR/PBIP Format) This skill enables reading, editing, and creation of Power BI report definition files in the **PBIR (Power BI Report)** format used by **PBIP (Power BI Project)** files. ## Must/Prefer/Avoid ### MUST - Use this skill only for concrete PBIR/PBIP report-file mechanics such as pages, visuals, filters, slicers, navigation, bookmarks, themes, formatting, validation, Desktop reloads, and screenshots. - Validate PBIR with `powerbi-report-author validate` after each logical batch. - Use `powerbi-desktop` reload/screenshot workflows for rendered-output changes. - Use CLI capability lookup before writing visual roles, formatting objects, enum values, selectors, or expression encodings. ### PREFER - Start from an approved `Design Brief:` or `_brief/report-spec.md` for greenfield report builds. - Route visual-design uncertainty to `powerbi-report-design` before writing files. - For semantic model metadata or model-side changes, use a semantic-model authoring skill, Power BI Modeling MCP, or local TMDL files when available. ### AVOID - Do not guess PBIR JSON from memory when CLI metadata or reference files are