diff --git a/README.md b/README.md index f74777c..e9461a2 100644 --- a/README.md +++ b/README.md @@ -1,5 +1,5 @@

- pbi-cli — Vibe Modeling + pbi-cli

@@ -18,7 +18,8 @@

Why pbi-cli • Get Started • - Just Ask Claude • + Modeling • + Reporting • Skills • All Commands • Contributing @@ -81,7 +82,9 @@ Add the printed path to your system PATH, then restart your terminal. We recomme --- -## Just Ask Claude +## Semantic Model Layer + +Ask Claude to work with your Power BI semantic model. Requires `pbi connect`.

Just Ask Claude @@ -117,21 +120,29 @@ Add the printed path to your system PATH, then restart your terminal. We recomme RLS testing

-### NEW: Build reports from CLI +--- + +## Report Layer + +Ask Claude to build and manage your Power BI reports. No connection needed -- works directly on PBIR files.

Ask Claude to build reports

+### Build a report in 6 steps +

Report workflow

+### Visuals, pages, themes, filters +

Report layer capabilities

-### 32 Visual Types +### 32 visual types

32 Visual Types @@ -139,38 +150,6 @@ Add the printed path to your system PATH, then restart your terminal. We recomme --- -## Skills - -After running `pbi connect`, Claude Code discovers **12 Power BI skills** automatically. Each skill teaches Claude a different area. You don't need to memorize commands. - -

- 12 Skills -

- -### Semantic Model Skills (require `pbi connect`) - -| Skill | What you say | What Claude does | -|-------|-------------|-----------------| -| **DAX** | *"What are the top 10 products by revenue?"* | Writes and executes DAX queries, validates syntax | -| **Modeling** | *"Create a star schema with Sales and Calendar"* | Creates tables, relationships, measures, hierarchies | -| **Deployment** | *"Save a snapshot before I make changes"* | Exports/imports TMDL, manages transactions, diffs snapshots | -| **Security** | *"Set up RLS for regional managers"* | Creates roles, filters, perspectives | -| **Docs** | *"Document everything in this model"* | Generates data dictionaries, measure inventories | -| **Partitions** | *"Show me the M query for the Sales table"* | Manages partitions, expressions, calendar config | -| **Diagnostics** | *"Why is this query so slow?"* | Traces queries, checks model health, benchmarks | - -### Report Layer Skills (no connection needed) - -| Skill | What you say | What Claude does | -|-------|-------------|-----------------| -| **Report** | *"Create a new report project for Sales"* | Scaffolds PBIR reports, validates structure, previews layout | -| **Visuals** | *"Add a bar chart showing revenue by region"* | Adds, binds, updates, bulk-manages 32 visual types | -| **Pages** | *"Add an Executive Overview page"* | Manages pages, bookmarks, visibility, drillthrough | -| **Themes** | *"Apply our corporate brand colours"* | Applies themes, conditional formatting, colour scales | -| **Filters** | *"Show only the top 10 products"* | Adds page/visual filters (TopN, date, categorical) | - ---- - ## Architecture

@@ -206,6 +185,38 @@ Bundled DLLs ship inside the Python package (`pbi_cli/dlls/`). --- +## Skills + +After running `pbi connect`, Claude Code discovers **12 Power BI skills** automatically. Each skill teaches Claude a different area. You don't need to memorize commands. + +

+ 12 Skills +

+ +### Semantic Model Skills (require `pbi connect`) + +| Skill | What you say | What Claude does | +|-------|-------------|-----------------| +| **DAX** | *"What are the top 10 products by revenue?"* | Writes and executes DAX queries, validates syntax | +| **Modeling** | *"Create a star schema with Sales and Calendar"* | Creates tables, relationships, measures, hierarchies | +| **Deployment** | *"Save a snapshot before I make changes"* | Exports/imports TMDL, manages transactions, diffs snapshots | +| **Security** | *"Set up RLS for regional managers"* | Creates roles, filters, perspectives | +| **Docs** | *"Document everything in this model"* | Generates data dictionaries, measure inventories | +| **Partitions** | *"Show me the M query for the Sales table"* | Manages partitions, expressions, calendar config | +| **Diagnostics** | *"Why is this query so slow?"* | Traces queries, checks model health, benchmarks | + +### Report Layer Skills (no connection needed) + +| Skill | What you say | What Claude does | +|-------|-------------|-----------------| +| **Report** | *"Create a new report project for Sales"* | Scaffolds PBIR reports, validates structure, previews layout | +| **Visuals** | *"Add a bar chart showing revenue by region"* | Adds, binds, updates, bulk-manages 32 visual types | +| **Pages** | *"Add an Executive Overview page"* | Manages pages, bookmarks, visibility, drillthrough | +| **Themes** | *"Apply our corporate brand colours"* | Applies themes, conditional formatting, colour scales | +| **Filters** | *"Show only the top 10 products"* | Adds page/visual filters (TopN, date, categorical) | + +--- + ## All Commands 27 command groups covering both the semantic model and the report layer. @@ -239,26 +250,6 @@ Run `pbi --help` for full options. --- -## Supported Visual Types (32) - -pbi-cli supports creating and binding data to 32 Power BI visual types: - -**Charts:** bar, line, column, area, ribbon, waterfall, stacked bar, clustered bar, clustered column, scatter, funnel, combo, donut/pie, treemap - -**Cards/KPIs:** card (legacy), cardVisual (modern), cardNew, multi-row card, KPI, gauge - -**Tables:** table, matrix (pivot table) - -**Slicers:** slicer, text slicer, list slicer, advanced slicer (tile/image) - -**Maps:** Azure Map - -**Decorative:** action button, image, shape, textbox, page navigator - -Use friendly aliases: `pbi visual add --page p1 --type bar` instead of `--type barChart`. - ---- - ## REPL Mode For interactive work, the REPL keeps a persistent connection: