# pbi-report-design

pbi-report-design is a Claude Code skill that defines Power BI report design rules and is loaded by other skills before layout or theme decisions.

- 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/pbi-report-design/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/pbi-report-design

## What it does

The skill defines design rules for Power BI reports: the 3-30-300 rule (important content in the top-left, details in the bottom-right), alignment and equal spacing between visuals, choosing a tone (`restrained`, `corporate`, `editorial`, `technical`) and signature (a recurring element across all pages), routing each page to one shape based on the question it answers (`summary`, `monitoring`, `exploration`, `comparison`, `narrative`).

Colors come from the theme rather than inline hex codes, so the identity propagates across the report. Fonts are `Segoe UI` and `Segoe UI Semibold`. The skill requires the `pbir` tool for any report mutations; if an operation is unavailable, work stops. Before modifying layout, the skill checks actual page dimensions from `page.json` to avoid exceeding bounds.

Called by `create-pbi-report`, `pbir-cli`, `review-report`, `modifying-theme-json`, and `custom-visual` skills before design, layout, color, chart-selection, or accessibility decisions.

## 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 pbi-report-design -a claude-code
```

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

### Codex

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

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

### Cursor

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

2. **Manually: put the files in place**
- File: `.cursor/skills/pbi-report-design/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/pbi-report-design
```

2. **Manually: put the files in place**
- File: `.github/skills/pbi-report-design/SKILL.md`

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

## When to use it
- lock report design identity before layout work
- align visuals and make spacing equal
- choose the right chart for a specific question
- enforce color discipline through the theme
- route a page to one shape based on its task

## Example prompts
- Lock the tone to `corporate` and add a header band signature to the report
- Check spacing equality between visuals on this page
- Choose a chart to compare trends across categories

## Similar
- [power-bi-report-design-best-practices](https://affpapa.org/en/nevibecode/rules/power-bi-report-design-best-practices.md) — rule · ★ 41430 repo stars
- [power-bi-report-design-consultation](https://affpapa.org/en/nevibecode/skills/power-bi-report-design-consultation.md) — skill · 9390 installs
- [Horizun PBI MCP](https://affpapa.org/en/nevibecode/mcp/horizun-pbi-mcp.md) — MCP server · ★ 34 repo stars
- [logifleet-pulse-supply-chain-analytics](https://affpapa.org/en/nevibecode/skills/logifleet-pulse-supply-chain-analytics.md) — skill · 659 installs
- [power-bi-retail-analytics-salespulse360](https://affpapa.org/en/nevibecode/skills/power-bi-retail-analytics-salespulse360.md) — skill · 659 installs
- [infographic-and-data-viz](https://affpapa.org/en/nevibecode/skills/infographic-and-data-viz.md) — skill · 1200 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
