# pbir-format

This skill helps Claude Code inspect Power BI reports in PBIR format and make changes through pbir. Use it to work with report pages, visuals, filters, and themes.

- 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/pbip/skills/pbir-format/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-format

## What it does

The skill guides Claude Code through PBIR report structure, including settings for pages, visuals, bookmarks, and themes. It can help locate properties and understand how a report connects to its semantic model. Legacy `report.json` and `layout` metadata are outside its scope.

For report changes, the workflow starts by understanding the request and examining the model and relevant visuals. New reports are created with `pbir new`; edits must go through `pbir` tools rather than direct JSON changes or scripts. Work on a local `.Report` folder in PBIR format, not a PBIT file.

Valid JSON does not guarantee that a visual will render. A bound field that is missing from the model, for example, can prevent it from displaying. Legacy reports need to be opened and saved in Power BI Desktop to convert them to PBIR.

## 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 pbip@power-bi-agentic-development
```
This installs the whole pbip plugin with all its skills

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

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

### Codex

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

2. **Manually: put the files in place**
- File: `.agents/skills/pbir-format/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-format -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/pbir-format/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/pbip/skills/pbir-format
```

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/pbir-format/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/pbip/skills/pbir-format/SKILL.md

## When to use it
- locate visual properties in a PBIR report
- trace page settings and report filters
- understand how themes affect visual formatting
- create a report with `pbir new`
- change a report without editing its JSON directly

## Example prompts
- Explain the formatting settings in `visual.json` for this report.
- Add a report filter through `pbir` and identify the page it applies to.
- Create a PBIR report with `pbir new` and configure its model connection.

## 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 DAX Expert Mode](https://affpapa.org/en/nevibecode/agents/power-bi-dax-expert-mode.md) — subagent · ★ 41430 repo stars
- [logifleet-pulse-supply-chain-analytics](https://affpapa.org/en/nevibecode/skills/logifleet-pulse-supply-chain-analytics.md) — skill · 659 installs

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
