Telemetry — MANDATORY. Every api.fabric.microsoft.com call must carry x-ms-fabric-skill: powerbi-report-cli (az rest: --headers "x-ms-fabric-skill=powerbi-report-cli"), including every LRO poll, fabric_lro and retry. Snippets omit it — add it anyway.

CRITICAL NOTES

1. To find workspace details, including its ID, from a workspace name: list all workspaces, then use JMESPath filtering.
2. To find item details, including its ID, from a workspace ID, item type, and item name: list all items of that type in that workspace, then use JMESPath filtering.
3. Use powerbi-report-cli for the report artifact: requirements, design, PBIR/PBIP page and visual edits, preview, and publishing. Semantic model, measure, and DAX work belongs to a semantic-model skill. Natural-language questions about report data belong to fabriciq.

Power BI Reports - CLI Skill

This skill owns the Power BI report lifecycle end to end: requirements and scope, visual design, local PBIR/PBIP authoring and preview, and report-item transport to and from Microsoft Fabric.

It is a mode dispatcher and intentionally contains no detailed procedures. Select the mode that matches the request, then read the matching mode reference end to end before acting. The mode file holds the required workflow, commands, payloads, templates, and failure rules.

Mode Selection

Mode Boundary Rules

• Classify by intent, not by which file or tool is already open.
• design decides what the report should look like; authoring writes the PBIR that realizes it. Choosing a chart type is design; encoding it into visual.json is authoring.
• Restyling or reformatting an existing local report is authoring, even when the request uses design language. Use design when the user wants advice or a design contract rather than a file change.
• authoring changes local files and performs preview/validation. It does not publish to Fabric.
• management transports definitions and manages Fabric report items. It does not invent or directly author PBIR content.
• planning owns the guided requirements-to-approval flow for a new report. A focused edit to an existing report goes directly to authoring.

A greenfield request can span modes in this order:

planning -> design -> authoring -> management

Handle one mode at a time. Announce each switch and read the new mode reference before starting that part. The planning approval gate is a turn boundary: never build or publish until the user explicitly approves the locked spec in a later reply.

GREENFIELD APPROVAL BARRIER — MANDATORY. When a new-report request asks to plan, build, and/or publish but the user has not approved a locked spec in a prior reply, set the current phase to approval_pending and keep planning as the only active mode. In this phase, do not load authoring or management, edit/scaffold PBIR or semantic-model files, generate synthetic data, call Fabric write APIs, or publish. Persist _brief/report-spec.md, ask for explicit approval, and end the turn. The build/publish wording in the original request is desired future scope, not approval to cross this barrier.

Required Deliverable by Mode

Rules

MUST

• Select the narrowest mode that fully covers the current request.
• Read references/<mode>.md end to end before the first command or file edit in that mode. When an already-loaded mode explicitly routes one narrow cross-mode operation to a named topic reference, treat that topic reference as the complete handoff; do not load the target mode's umbrella file unless the work expands beyond that operation.
• In planning mode, also read references/planning-part-02.md before producing _brief/report-spec.md; it contains the required canonical design contract and approval checks.
• Across a multi-turn task, retain a compact working state containing resolved workspace/item/model IDs, local and downloaded paths, and references already read. Reuse it in later turns unless the user explicitly requests a fresh query or the preceding operation invalidated a value.
• Preserve every argument and safety boundary documented by the selected mode.
• Announce and perform an explicit mode switch when the request crosses a boundary.
• Use the powerbi-report-author CLI metadata and validation surfaces instead of guessing PBIR schemas, roles, formatting properties, selectors, or enum values.
• Keep local edits local unless the user explicitly requests publishing.
• Resolve Fabric workspace and item IDs by listing and filtering rather than guessing identifiers.
• Produce the artifact the user requested; reading or summarizing a reference is not task completion.

PREFER

• Infer facts already present in the prompt, semantic model, existing PBIP, or prior approved spec instead of asking again.
• Load only the selected mode and its directly relevant topic references.
• Reuse reference guidance already loaded in the current task. Open a new reference only when the requested operation or an observed mismatch requires it.
• Preserve the user's existing project structure, schemas, host, operation, binding, and delivery target unless the selected mode explicitly requires a change.

AVOID

• Acting from this dispatcher without reading the selected mode reference.
• Reloading this dispatcher, a mode file, or a topic reference already read in the current task solely because the conversation advanced to a later turn.
• Loading a retired sibling skill name; planning, design, authoring, and management are modes of this skill.
• Editing PBIR or calling Fabric APIs in planning or design.
• Publishing from authoring, or authoring PBIR content from management.
• Bypassing the planning approval gate because the original request also asked to build or publish.

Complete Reference Index

Open every relevant reference directly from this index. Files named part-XX continue the named topic.

Authoring

• authoring/authoring-workflows
• authoring/bookmark
• authoring/button-part-02
• authoring/button-part-03
• authoring/button
• authoring/card-part-02
• authoring/card-part-03
• authoring/card
• authoring/cartesian-part-02
• authoring/cartesian-part-03
• authoring/cartesian-part-04
• authoring/cartesian
• authoring/color-strategy
• authoring/conditional-formatting-part-02
• authoring/conditional-formatting-part-03
• authoring/conditional-formatting-part-04
• authoring/conditional-formatting-part-05
• authoring/conditional-formatting-part-06
• authoring/conditional-formatting-part-07
• authoring/conditional-formatting
• authoring/custom-visuals
• authoring/expressions
• authoring/field-parameters
• authoring/filter-pane
• authoring/filters
• authoring/formatting-overview
• authoring/formatting-part-02
• authoring/formatting
• authoring/image
• authoring/kpi
• authoring/map
• authoring/model-binding
• authoring/page-formatting
• authoring/powerbi-desktop
• authoring/powerbi-report-author-cli-part-02
• authoring/powerbi-report-author-cli
• authoring/preview-part-02
• authoring/preview-part-03
• authoring/preview-part-04
• authoring/preview
• authoring/re-theming-part-02
• authoring/re-theming-part-03
• authoring/re-theming
• authoring/screenshot-review
• authoring/shape
• authoring/slicers-part-02
• authoring/slicers
• authoring/table
• authoring/textbox
• authoring/theming-part-02
• authoring/theming
• authoring/version-control

Design

• design/accessibility
• design/anti-patterns
• design/archetype-composition
• design/archetypes/analytical-canvas
• design/archetypes/comparative-benchmark-part-02
• design/archetypes/comparative-benchmark
• design/archetypes/executive-summary
• design/archetypes/narrative-story
• design/archetypes/operational-monitor
• design/brownfield
• design/chart-selection
• design/color
• design/design-brief-part-02
• design/design-brief
• design/interactivity
• design/layout
• design/pre-flight-checklist
• design/signatures
• design/tone-catalog
• design/typography
• design/visual-cookbook-part-02
• design/visual-cookbook

Mode Guides

• authoring-part-02
• authoring-part-03
• authoring-part-04
• authoring
• design
• management-part-02
• management-part-03
• management-part-04
• management
• planning-part-02
• planning

Examples

Route Compatibility

The merged skill preserves the four previous route surfaces. Treat the following phrases as explicit aliases for the corresponding mode: