microsoft/skills-for-fabric

powerbi-report-cli

Rozdziel pracę nad Power BI na planowanie, projekt, lokalną edycję PBIR/PBIP i osobne zarządzanie w Fabric.

Zobacz źródło

Szczegółowy opis

Ten Skill kieruje pracę nad artefaktem raportu do planowania, projektu, edycji i zarządzania, z osobnymi materiałami. Dla nowego raportu planowanie zamienia wymagania i kontekst modelu w specyfikację zatwierdzaną przed wdrożeniem; projekt ustala założenia wizualne. Wąska zmiana istniejącego lokalnego raportu może od razu trafić do edycji.

Edycja obejmuje strony, wizualizacje, filtry i motywy PBIR/PBIP. Udokumentowane zakończenie wymaga walidacji schematu, wczytania najnowszych plików, zrzutów zmienionych stron i ich oceny. Zarządzanie osobno przesyła definicje i obsługuje elementy raportów w Fabric. Podgląd nie publikuje, a lokalna edycja nie upoważnia do nadpisania raportu zdalnego.

Pakiet dostarcza instrukcje, nie gotowe środowisko Power BI ani uprawnienia Fabric. Edycja wymaga projektu i kontekstu modelu; opisany transport korzysta z Azure CLI i powerbi-report-author. Miary, DAX i model semantyczny należą do osobnego przepływu, a pytania o dane w języku naturalnym są kierowane do fabriciq.

Co przygotować

  • Konkretne zadanie: zaplanowanie, ustalenie wyglądu, edycja istniejącego raportu lub zarządzanie elementem Fabric.
  • Właściwy projekt PBIR/PBIP oraz kontekst tabel, kolumn i miar; do podglądu wybrany host i wymagane identyfikatory powiązań.
  • Do zarządzania zdalnego uwierzytelniony dostęp Fabric, dokładne ID obszaru, raportu i modelu oraz wymagane narzędzia.

Oczekiwane wyniki

  • Planowanie daje specyfikację, projekt — opis wizualny, edycja — lokalne pliki z kontrolą struktury i wyglądu.
  • Zarządzanie wykonuje żądaną operację Fabric, czeka na zakończenie i sprawdza wynik odczytem zwrotnym, zgodnie z dostępem i zgodą.

Sposób użycia

  1. Wybierz najwęższy tryb według celu i przeczytaj cały materiał oraz wskazane kontynuacje.
  2. Nowy raport zacznij od ukończenia i zatwierdzenia specyfikacji, potem przejdź do projektu i realizacji; zachowaj istniejącą pracę.
  3. Edytuj logicznymi partiami, waliduj schemat, wczytaj aktualne pliki i oceń zrzuty wszystkich zmienionych stron.
  4. Do zarządzania przejdź tylko przy wyraźnie zleconej operacji zdalnej; sprawdź cel i wynikową definicję.

Ograniczenia i kontrola

  • Instalacja instrukcji nie instaluje wszystkich CLI, nie przygotowuje hosta i nie nadaje praw dzierżawy ani obszaru.
  • Poprawny schemat nie wyklucza starego podglądu, braku powiązań z danymi czy złego układu.
  • Rozwiąż niezapisane zmiany hosta przed wczytaniem plików; stary zrzut nie potwierdza nowych zmian.
  • Materiał zarządzania wymaga nowoczesnego PBIR i powerbi-report-author ≥0.3.0; przed pakowaniem sprawdź definition/report.json i walidację.
  • Miary i DAX przenieś do właściwego przepływu modelu; zgoda na edycję lub podgląd nie oznacza zgody na zdalne nadpisanie.

Częste pytania

Czy potrzebuję czterech osobnych pakietów Skill?

powerbi-report-cli zawiera cztery tryby. Wybierz według zadania i przeczytaj odpowiedni materiał; nie każda mała edycja wymaga wszystkich faz.

Czy odpowiada na pytania o dane?

Główny zakres to artefakt raportu. Pytania o dane trafiają do fabriciq, a zmiany modelu lub DAX do odpowiedniego pakietu do obsługi modeli semantycznych.

Czy udana walidacja wystarczy?

Nie. Edycja wymaga też wczytania zmienionego PBIR i oceny świeżych zrzutów wszystkich stron objętych zmianą. Zmiana globalna wymaga przeglądu całego raportu.

Czy edycja automatycznie publikuje w Fabric?

Tryb edycji pozostaje lokalny. Zdalne zarządzanie ma osobne wymagania celu, uwierzytelnienia i praw; źródło wymaga wyraźnej zgody na publikację oraz nadpisanie.

Zainstaluj ten Skill

Dodaj Skill z jego zweryfikowanego źródła GitHub za pomocą Skills CLI.

npx skills add https://github.com/microsoft/skills-for-fabric --skill powerbi-report-cli

Informacje o źródle

Oryginalny dokument Skill

Treść z repozytorium z zachowaniem nagłówków, przykładów, kodu, tabel, linków i obrazów.

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

ModeUse when the request...Existing route examplesRead first
planningcreates a new report/dashboard and needs requirements, model/dependency inspection, scope, a page plan, and approval before implementationcreate a report, build a dashboard, create from a semantic model, plan then implement, walk me through creating a reportreferences/planning.md, then references/planning-part-02.md
designdecides what a report should look like: tone, signature, page archetype, chart type, layout, color, typography, theme direction, accessibility, brand application, redesign, or critiquedesign a Power BI report, make the dashboard professional, choose a chart, apply a brand, redesign the report, create a design briefreferences/design.md
authoringreads or edits local PBIR/PBIP files, validates them, previews the report, or captures screenshotsedit PBIR, create/add a report page or visual, format a visual, add filters/slicers/bookmarks/themes, validate PBIR, preview/reload/screenshot in Desktop or servicereferences/authoring.md
managementmoves a report definition to or from Fabric or manages the workspace report itempublish/upload/download PBIR or PBIP, list reports, get/update/delete a report, rebind a reportreferences/management.md

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:

text
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

ModeCompletion requirement
planningPersist _brief/report-spec.md or the user-named equivalent, ask for explicit approval, and stop before implementation.
designProduce the complete Design Brief: contract, including design_identity and a page archetype/layout contract for every page. Do not edit PBIR or call Fabric APIs.
authoringPersist the requested PBIR/PBIP changes, validate each logical batch, then complete the selected preview and screenshot-review workflow required by the authoring reference. Do not publish.
managementComplete the requested Fabric report operation, including LRO polling and documented readback verification.

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.

<!-- BEGIN GENERATED REFERENCE INDEX -->

Complete Reference Index

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

Authoring

Design

Mode Guides

<!-- END GENERATED REFERENCE INDEX -->

Examples

User requestMode
"Create a new executive report from this semantic model."planning
"Design an operational page and choose the right charts."design
"Add a KPI page to this PBIP, validate it, and take screenshots."authoring
"Publish this local PBIP to my Fabric workspace and rebind it."management

Route Compatibility

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

ModePreserved route phrases
planningcreate a report; build a report; create a dashboard; create a new report from scratch; create a report from a semantic model or dataset link; build a report for this model; make me a dashboard; plan then implement; walk me through creating a report
designdesign Power BI report; make dashboard look professional; choose chart type; apply brand to report; redesign report; create design brief; Power BI report design archetype
authoringedit PBIR; create Power BI report page; add visual to PBIP; format report visual; validate Power BI report; preview Power BI report; Power BI Desktop preview status; preview report in service; preview report in browser; screenshot report page; screenshot all report pages; list preview hosts; implement dashboard in PBIP; add dashboard visuals to report; implement an approved PBIP report spec; edit PBIR pages/visuals; edit a Power BI report
managementupload PBIR report definition; upload Power BI report; download PBIR definition; publish PBIR definition; publish Power BI report to Fabric; manage Power BI reports; list workspace reports

Powiązane zadania

z tego samego repozytorium

Więcej Skills

Wszystkie Skills
microsoft
Oficjalne

databasehub-cli

Analyzes Database Hub inventory, health, and security posture through Entra-authenticated Fabric APIs. Use for estate counts; SQL/PostgreSQL CPU, storage, and memory; Cosmos DB availability/RU; authentication/auditing/CMK warnings; and Fabric SQL inventory. Fabric SQL tuning routes to sqldb-cli; Warehouse/Lakehouse/Mirrored Database SQL to sqldw-cli. Triggers: data estate performance, database estate health, database security posture.

Instalacje / 1h
1
GitHub Stars
1,3 tys.
Aktualizacja
5 lis
microsoft
Oficjalne

e2e-fabric-cost-estimation

Estimates Fabric capacity cost before a migration by profiling Spark, SQL, Power BI, and Real-Time workloads, then recommending SKU size and comparing Reserved, Pay-As-You-Go, and Autoscale billing. Use only for capacity sizing and pricing questions, not for general migration or connectivity work.

Instalacje / 1h
1
GitHub Stars
1,3 tys.
Aktualizacja
5 lis
microsoft
Oficjalne

onelake-catalog-cli

Governs and curates the Microsoft Fabric OneLake catalog through Fabric Admin, Core and Power BI REST APIs. Use for tenant or data-owner governance audits and guarded remediation of domains, workspace assignment, capacity, labels, tag definitions, workspace tags, certification, refresh and item identity, and for owners curating an item's description, name, tags and table and column descriptions. Item discovery belongs to search-consumption-cli.

Instalacje / 1h
1
GitHub Stars
1,3 tys.
Aktualizacja
5 lis
microsoft
Oficjalne

eventschemaset-cli

Governs Event Schema Sets, the Fabric registries of event types and message payload schemas. Covers create, rename, update and delete of a definition, and listing, property reads or base64 decoding. Every Event Schema Set task belongs here. Ingestion pipelines are eventstream-cli.

Instalacje / 1h
1
GitHub Stars
1,3 tys.
Aktualizacja
5 paź