bpa-rules — Claude Code skill: what it does, how to install
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.
GPL-3.0 ★ 1,104 updated 2026-10-28
/plugin marketplace add data-goblin/power-bi-agentic-development
/plugin install tabular-editor@power-bi-agentic-developmentWhat bpa-rules 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.
What it helps with
- 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 for the agent
- 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
How to install bpa-rules
1Plugin marketplace
/plugin marketplace add data-goblin/power-bi-agentic-development/plugin install tabular-editor@power-bi-agentic-developmentThis installs the whole tabular-editor plugin with all its skills
2Skills CLI (Vercel)
npx skills add data-goblin/power-bi-agentic-development --skill bpa-rules -a claude-code3Manually: put the files in place
~/.claude/skills/bpa-rules/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/bpa-rules/
1Skills CLI (Vercel)
npx skills add data-goblin/power-bi-agentic-development --skill bpa-rules -a codex2Manually: put the files in place
.agents/skills/bpa-rules/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add data-goblin/power-bi-agentic-development --skill bpa-rules -a cursor2Manually: put the files in place
.cursor/skills/bpa-rules/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install data-goblin/power-bi-agentic-development plugins/tabular-editor/skills/bpa-rules2Manually: put the files in place
.github/skills/bpa-rules/SKILL.md1Skills CLI (Vercel)
npx skills add data-goblin/power-bi-agentic-development --skill bpa-rules -a gemini-cli2Platform CLI
gemini skills install https://github.com/data-goblin/power-bi-agentic-development --path plugins/tabular-editor/skills/bpa-rulesManually: put the files in place
.devin/skills/bpa-rules/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about bpa-rules
How to install bpa-rules in Claude Code?
Run /plugin marketplace add data-goblin/power-bi-agentic-development followed by /plugin install tabular-editor@power-bi-agentic-development.
What does the bpa-rules skill do?
It conducts an interactive interview to understand your governance requirements, inspects your Power BI model structure, and creates custom Best Practice Analyzer rules.
Can it analyze standard .pbix binary files directly?
No, it requires access to model definitions. You must save the report as a Power BI Project (PBIP) to expose the TMDL files, or supply a model.bim file.