# powerbi-custom-visuals

powerbi-custom-visuals is a Claude Code skill for building interactive Power BI visuals with the pbiviz toolchain, from project setup through packaging and certification prep. It supports visuals reused across reports.

- 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/custom-visuals/skills/powerbi-custom-visuals/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/powerbi-custom-visuals

## What it does

The skill guides TypeScript development for Power BI visuals: scaffold a project, implement its `IVisual` class, define data roles and formatting options, preview changes, and produce a `.pbiviz` package. It includes an MCP server for API lookup, best-practice guidance, feature implementation, project inspection, and certification checks.

You need Node.js 20.19 or newer and the `powerbi-visuals-tools` CLI. Live preview also requires developer mode in Power BI Desktop or Power BI service. Packaging writes the file to `dist/`. Certification checks include ESLint and `npm audit`; `eval`, `fetch`, and `XMLHttpRequest` are disallowed, so those restrictions shape how the visual can be built.

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

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

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

### Codex

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

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

### Cursor

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

2. **Manually: put the files in place**
- File: `.cursor/skills/powerbi-custom-visuals/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/custom-visuals/skills/powerbi-custom-visuals
```

2. **Manually: put the files in place**
- File: `.github/skills/powerbi-custom-visuals/SKILL.md`

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

## When to use it
- scaffold a Power BI visual project
- implement an `IVisual` class and its update flow
- map data roles to formatting options
- check a visual before certification
- package a visual as `.pbiviz`

## Example prompts
- Scaffold an interactive Power BI visual project with `pbiviz`.
- Show how `capabilities.json` maps to the formatting pane.
- Check this visual project for certification issues and risky dependencies.

## Similar
- [power-bi-custom-visuals-development](https://affpapa.org/en/nevibecode/rules/power-bi-custom-visuals-development.md) — rule · ★ 41430 repo stars
- [powerbi-modeling](https://affpapa.org/en/nevibecode/skills/powerbi-modeling.md) — skill · 9934 installs
- [powerbi-expert](https://affpapa.org/en/nevibecode/skills/powerbi-expert.md) — skill · 383 installs
- [documd-visuals](https://affpapa.org/en/nevibecode/skills/documd-visuals.md) — skill · 534 installs
- [pitch-deck-visuals](https://affpapa.org/en/nevibecode/skills/pitch-deck-visuals.md) — skill · 240 installs
- [repo-visuals](https://affpapa.org/en/nevibecode/plugins/repo-visuals.md) — plugin · ★ 20 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
