# bpa-rules

bpa-rules is a Claude Code skill for authoring Best Practice Analyzer rules for Power BI and Tabular Editor semantic models through guided discovery and model inspection.

- 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/tabular-editor/skills/bpa-rules/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/bpa-rules

## What it does

The skill implements a structured Double Diamond discovery workflow before authoring any Best Practice Analyzer rules. It uses `AskUserQuestion` to interview you about your team setup, Tabular Editor version, existing conventions, and audit goals across multiple conversation rounds.

Next, it inspects your semantic model. The skill reads TMDL files from PBIP directories, inspects `model.bim` using `jq`, or queries published Fabric models with the `fab` CLI. It checks DAX patterns, relationship directions, missing measure descriptions, and RLS definitions. If you only have a local `.pbix` file, the skill cannot inspect it directly until you save it as a PBIP project in Power BI Desktop.

Once priorities are agreed upon, the skill outputs tailored BPA rules with severity settings and optional `FixExpression` blocks for automated remediation.

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

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

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

### Codex

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

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

### Cursor

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

2. **Manually: put the files in place**
- File: `.cursor/skills/bpa-rules/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/tabular-editor/skills/bpa-rules
```

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

### Gemini CLI

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

2. **Platform CLI**
```bash
gemini skills install https://github.com/data-goblin/power-bi-agentic-development --path plugins/tabular-editor/skills/bpa-rules
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/bpa-rules/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/tabular-editor/skills/bpa-rules/SKILL.md

## When to use it
- Generate tailored BPA rules for Tabular Editor semantic models
- Inspect TMDL files in PBIP projects for missing descriptions and unused columns
- Write FixExpression scripts to automate fixes for model violations
- Audit published Microsoft Fabric models using the fab command line

## Example prompts
- Set up BPA rules for our Power BI semantic model in PBIP format
- Audit our Tabular Editor model and generate rules for DAX quality
- Create a BPA rule with a FixExpression to clean up unformatted measures

## Similar
- [Horizun PBI MCP](https://affpapa.org/en/nevibecode/mcp/horizun-pbi-mcp.md) — MCP server · ★ 34 repo stars
- [power-bi-dax-optimization](https://affpapa.org/en/nevibecode/skills/power-bi-dax-optimization.md) — skill · 9100 installs
- [power-bi-model-design-review](https://affpapa.org/en/nevibecode/skills/power-bi-model-design-review.md) — skill · 9000 installs
- [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-retail-analytics-salespulse360](https://affpapa.org/en/nevibecode/skills/power-bi-retail-analytics-salespulse360.md) — skill · 659 installs
- [power-bi-salespulse-dashboard](https://affpapa.org/en/nevibecode/skills/power-bi-salespulse-dashboard.md) — skill · 658 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
