bpa-expression-helper — Claude Code subagent: setup and use
bpa-expression-helper — a subagent for debugging, fixing, and explaining Best Practice Analyzer rule expressions with Dynamic LINQ and TOM properties in Power BI.
GPL-3.0 ★ 1,104 updated 2026-10-28
.github/agents/bpa-expression-helper.agent.mdWhat bpa-expression-helper does
The subagent inspects Best Practice Analyzer (BPA) rule expressions for tabular data models. It detects syntax mistakes and broken logic in Dynamic LINQ code. When working through an issue, it uses the Read, Grep, and Glob tools to inspect definitions and cross-check rules against skills/bpa-rules/references/expression-syntax.md.
During evaluation, the assistant reviews the designated Scope and verifies string comparisons or equality operators. It catches frequent errors such as invalid property access across collections, measure attributes applied to column scopes, or missing outerIt qualifiers in nested calls. The subagent relies on skills/bpa-rules/references/expression-syntax.md to look up language details.
Every response follows a predictable layout. The agent states the root cause, delivers the corrected expression, clarifies why the update works, and suggests a simple test case to verify the fix.
What it helps with
- debug failing Dynamic LINQ expressions in BPA rules
- resolve scope mismatches between measures and columns
- write filter expressions targeting unreferenced or hidden model objects
- fix nested LINQ queries missing
outerItreferences
Example prompts for the agent
- My BPA rule does not trigger any warnings, can you check the syntax?
- Help me create an expression to flag measures that lack descriptions.
- Why does my rule fail to find hidden columns in this table?
How to install bpa-expression-helper
Manually: put the files in place
.github/agents/bpa-expression-helper.agent.md1Plugin marketplace
/plugin marketplace add data-goblin/power-bi-agentic-development/plugin install tabular-editor@power-bi-agentic-development2Manually: put the files in place
.claude/agents/bpa-expression-helper.mdFor 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
Manually: put the files in place
.codex/agents/bpa-expression-helper.tomlCodex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/
Manually: put the files in place
.cursor/agents/bpa-expression-helper.mdCursor also reads .claude/agents/
Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean
Questions about bpa-expression-helper
How to install bpa-expression-helper in Claude Code?
First add the catalog by running /plugin marketplace add data-goblin/power-bi-agentic-development, then install the package with /plugin install tabular-editor@power-bi-agentic-development.
What does bpa-expression-helper do?
It diagnoses broken Best Practice Analyzer expressions, optimizes Dynamic LINQ logic, and explains how to query Power BI tabular object properties.
Which expression issues does the helper detect?
It spots Scope mismatches, invalid boolean comparisons, improper collection traversals without methods like Any, and missing outerIt keywords in nested queries.