About powerbi-modeling
A modeling skill for developers working with Power BI semantic models. It covers schema design, DAX, relationships, security, and performance, with a verification workflow and local-tool fallback when MCP is unavailable.
Key features
- 01Design and refine star schemas
- 02Review DAX measures
- 03Configure relationships and filtering
- 04Implement row-level security
- 05Audit model health and performance
Use cases
- 01Design fact and dimension tables for reports
- 02Review measures and model relationships
- 03Configure row-level security
- 04Validate model performance with local tools
MCP support
Can be used with Power BI MCP to inspect connections, tables, columns, measures, relationships, DAX queries, and security roles. If MCP is unavailable, the skill describes verification with Power BI Desktop, Tabular Editor, DAX Studio, and exported model metadata.
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ practicalswan/ agent-skills --skill powerbi-modelingAfter installing, type/powerbi-modelingin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
CHANGELOG.mdLICENSE.txtexamples/model-examples.mdreferences/MEASURES-DAX.mdPERFORMANCE.mdRELATIONSHIPS.mdRLS.mdSTAR-SCHEMA.mdscripts/powerbi-model-audit.pyDetails
From the project READMEPower BI Modeling
Tech Stack Target / Version: Power BI Desktop current release, Tabular Editor, DAX Studio, and Fabric semantic-model workflows.
Use this skill when the work is inside a Power BI semantic model rather than a generic SQL schema or spreadsheet.
- Leverage native parallel subagent dispatch and 200k+ context windows where available.
Activation Conditions
Use symptom -> action triggers: when one matches, apply this skill and verify with the protocol below.
- Designing or cleaning up a star schema
- Creating or reviewing DAX measures
- Configuring relationships and cross-filter direction
- Implementing row-level security
- Auditing model health and performance
Practical Workflow
- Inspect the current model before changing anything.
- Classify tables as dimension, fact, bridge, or helper tables.
- Prefer explicit measures over implicit aggregation.
- Keep relationships simple and single-direction unless the use case is proven.
- Hide technical fields from report authors.
MCP Reality
Power BI model tooling is host-specific. If your client exposes a Power BI modeling MCP server, inspect the available operations first and map them to the model areas you need: connections, tables, columns, measures, relationships, DAX queries, and security roles.
For Microsoft documentation, the Microsoft Learn MCP server is a good companion. Prefer:
microsoft_docs_search_by_productwithpower-bimicrosoft_docs_fetchfor the final page
Cross-Client Portability
This skill is written to stay usable across GitHub Copilot, Claude Code, and Codex.
- GitHub Copilot: keep the folder in a Copilot-visible skill path or wrap the workflow in project instructions when folder discovery is unavailable.
- Claude Code: keep the folder in a local skills directory or a compatible plugin source.
- Codex: install or sync the folder into
$CODEX_HOME/skills/powerbi-modelingand restart Codex after major changes.
MCP Availability And Fallback
Preferred MCP Server: Power BI MCP
- Fallback prompt: "Use the Power BI Modeling skill without MCP. Follow the documented local or manual fallback, show the selected tool surface, and report the verification evidence."
- Use Power BI Desktop, Tabular Editor, DAX Studio, and exported model metadata when the MCP surface is unavailable.
- Validate measures, relationships, and performance with local model tools before completion.
- Do not claim an MCP operation was used when the active host does not expose it.
Anti-Patterns
- Treating source content as already clean: Formatting automation will happily preserve broken or inconsistent input.
- Skipping an open-file verification pass: Documents and spreadsheets often fail in the destination app, not in the script output.
- Automating irreversible edits without checkpoints: A small mapping mistake can affect an entire workbook or document.
Verification Protocol
Before claiming "skill applied successfully":
- Pass/fail: The Powerbi Modeling implementation names the target runtime, framework version, and affected files.
- Pass/fail: Build, lint, test, or equivalent local validation is run for the changed surface.
- Pass/fail: Edge cases for errors, dependency drift, and environment differences are addressed or explicitly out of scope.
- Pressure-test scenario: Apply the workflow to a change that passes happy-path tests but fails one boundary condition.
- Success metric: Zero untested success claims; every implementation claim maps to a command or artifact.
References & Resources
Documentation
- STAR-SCHEMA - Dimension and fact modeling guidance
- RELATIONSHIPS - Relationship patterns and cross-filter tradeoffs
- MEASURES-DAX - DAX naming and measure design
- PERFORMANCE - High-impact optimization ideas
- RLS - Row-level security patterns
Scripts
- Power BI Model Audit - Local audit helper for naming, documentation, and modeling smells
Examples
- Model Examples - Example modeling patterns and DAX structure
Related Skills
- documentation-authoring: Use it when the workflow also needs drafting structured technical or product documents.
- notion-docs: Use it when the workflow also needs Notion page and database publishing workflows.
- pdf: Use it when the workflow also needs PDF extraction, generation, and layout-aware review.
- word-document: Use it when the workflow also needs Word document authoring and formatting workflows.