# pbir-cli

pbir-cli — a skill for creating, editing, and publishing Power BI reports through command-line tools. Modify report structure, formatting, and data; take screenshots and verify results in Power BI Desktop or Fabric.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 1104 repo stars
- Author: Kurt Buhler
- License: GPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/data-goblin/power-bi-agentic-development/tree/HEAD/plugins/reports/skills/pbir-cli/SKILL.md
- Updated: 2026-10-28
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/pbir-cli

## What it does

pbir-cli provides a command-line interface to Power BI reports in PBIR, PBIP, and PBIX formats with PBIR metadata. Commands let you explore report structure, add pages and visuals, adjust their properties (size, color, fonts, titles), apply themes, and validate changes. The tool runs on Windows, macOS, and Linux.

When a report is open in Power BI Desktop, the skill can refresh the canvas with `pbir desktop refresh` and capture a screenshot to verify the result. On other systems, reports are published to a Fabric sandbox and reviewed in a browser. All edits go through the CLI—direct JSON file modification is not allowed.

Setup requires installing the CLI. On most machines, run `uv tool install pbir-cli` or `pip install pbir-cli`. If installation is not possible (no Python, no network access), a portable build is available via `bin/fetch.sh`, though it requires manual updates.

## Requirements
- Works with: Power BI

## Install

### Claude Code (native platform)

1. **Plugin marketplace**
In the agent chat (not a shell):
```text
/plugin marketplace add data-goblin/power-bi-agentic-development
```
In the agent chat (not a shell):
```text
/plugin install reports@power-bi-agentic-development
```
This installs the whole reports plugin with all its skills

2. **Skills CLI (Vercel)**
```bash
npx skills add data-goblin/power-bi-agentic-development --skill pbir-cli -a claude-code
```

3. **Manually: put the files in place**
- File: `~/.claude/skills/pbir-cli/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/pbir-cli/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add data-goblin/power-bi-agentic-development --skill pbir-cli -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/pbir-cli/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add data-goblin/power-bi-agentic-development --skill pbir-cli -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/pbir-cli/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install data-goblin/power-bi-agentic-development plugins/reports/skills/pbir-cli
```

2. **Manually: put the files in place**
- File: `.github/skills/pbir-cli/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add data-goblin/power-bi-agentic-development --skill pbir-cli -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/data-goblin/power-bi-agentic-development --path plugins/reports/skills/pbir-cli
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/pbir-cli/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/data-goblin/power-bi-agentic-development/tree/HEAD/plugins/reports/skills/pbir-cli/SKILL.md

## When to use it
- build and modify Power BI report structure programmatically
- apply formatting rules to visuals across multiple reports
- preview reports without opening Power BI Desktop
- publish reports to Power BI Service and Fabric workspaces
- query data from a report's semantic model

## Example prompts
- Add a card visual to the Dashboard page showing total sales for the month
- Apply the company theme to the chart and take a screenshot
- Publish the report to a workspace and verify how it renders in the browser

## Similar
- [Horizun PBI MCP](https://affpapa.org/en/nevibecode/mcp/horizun-pbi-mcp.md) — MCP server · ★ 34 repo stars
- [power-bi-performance-troubleshooting](https://affpapa.org/en/nevibecode/skills/power-bi-performance-troubleshooting.md) — skill · 8900 installs
- [power-bi-retail-analytics-dashboard](https://affpapa.org/en/nevibecode/skills/power-bi-retail-analytics-dashboard.md) — skill · 384 installs
- [pbirb-mcp](https://affpapa.org/en/nevibecode/mcp/pbirb-mcp.md) — MCP server · ★ 6 repo stars
- [Power BI Authoring MCP Server (Local)](https://affpapa.org/en/nevibecode/mcp/power-bi-authoring-mcp-server-local.md) — MCP server · ★ 1297 repo stars
- [Power BI DAX Expert Mode](https://affpapa.org/en/nevibecode/agents/power-bi-dax-expert-mode.md) — subagent · ★ 41430 repo stars

From the same set: [data-goblin/power-bi-agentic-development](https://affpapa.org/en/nevibecode/by/data-goblin/power-bi-agentic-development.md) — 59 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
