# pbip-validator

pbip-validator — a subagent that diagnoses structural errors, JSON schema violations, and TMDL syntax issues in Power BI projects. Runs when you need to verify project integrity before opening in Desktop or after renaming tables.

- subagent · `type=agent` · Claude Code, Codex, Cursor, GitHub Copilot · ★ 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/agents/pbip-validator.agent.md
- Updated: 2026-10-28
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/agents/pbip-validator

## What it does

pbip-validator automates Power BI Project (PBIP) validation. It runs deterministic tools in sequence: first checks project structure (root `.pbip` files, `.platform` identities, dataset reference resolution, theme resource files on disk), then delegates report validation to `pbir validate` for each `.Report/` folder (JSON syntax, Microsoft schemas, visual and page naming rules, field references). For TMDL, the subagent validates syntax manually: table names matching filenames, proper indentation (tabs only), correct references in relationships and cultures. It also detects collisions between M-expression names and table names — a common silent blocker that causes Desktop to reject the project.

After a table rename, pbip-validator scans the entire project for remaining references to the old name across TMDL, JSON, DAX, and embedded selectors. Findings are reported with exact file paths and specific remediation steps.

## Requirements
- Works with: Power BI

## Install

### GitHub Copilot (native platform)

**Manually: put the files in place**
- File: `.github/agents/pbip-validator.agent.md`

### Claude Code

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
```

2. **Manually: put the files in place**
- File: `.claude/agents/pbip-validator.md` — For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention. Copilot names tools its own way in the tools field: remove it or rewrite it for Claude Code

### Codex

**Manually: put the files in place**
- File: `.codex/agents/pbip-validator.toml` — Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

### Cursor

**Manually: put the files in place**
- File: `.cursor/agents/pbip-validator.md` — Cursor also reads .claude/agents/

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/agents/pbip-validator.agent.md

## When to use it
- Find why a PBIP project won't open in Power BI Desktop
- Verify project integrity after renaming a table or column
- Check TMDL syntax in the semantic model
- Validate JSON in visuals against the PBIR schema
- Locate missing theme resource files

## Example prompts
- Validate my PBIP project for errors
- Did the table rename cascade through all references?
- Check this Report folder — it won't open in Desktop

## 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
- [logifleet-pulse-supply-chain-analytics](https://affpapa.org/en/nevibecode/skills/logifleet-pulse-supply-chain-analytics.md) — skill · 659 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
- [plugin-validator](https://affpapa.org/en/nevibecode/skills/plugin-validator.md) — skill · 122 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
