semantic-model

Design, build, refresh, and review Power BI tabular semantic models via the te CLI.

6|3|Updated Jul 4, 2026
One-click install
npx skills add https://github.com/InsightfulAnalytics/PBI_Agentic_Dev --skill semantic-model-insightfulanalytics
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: semantic-model
Source: https://github.com/InsightfulAnalytics/PBI_Agentic_Dev/tree/main/plugins/semantic-models/skills/semantic-model
Command: npx skills add https://github.com/InsightfulAnalytics/PBI_Agentic_Dev --skill semantic-model-insightfulanalytics

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires requests, and includes scripts (resource) and references (resource) components.

What problem does it solve? Building and maintaining Power BI / Analysis Services semantic models from the terminal is error-prone: agents pick the wrong tool, break relationships, or ship models with DAX correctness bugs, bloated VertiPaq storage, and missing metadata. This Skill provides a single operating loop that routes every modeling operation to the narrowest capable tool and audits models against best-practice categories. ## Core Features & Use Cases - Tool cascade routing: Drives every change through the te CLI first (measures, relationships, roles/RLS, calculation groups, incremental refresh), falls back to TOM via te script or connect-pbid for unreachable properties, and uses fab + TMDL authoring only for service- and file-shape operations. - Full lifecycle coverage: Design (star schema, storage modes, Direct Lake), build (measures with full metadata, validation and BPA gates), refresh (incremental refresh policy, framing), and review (prioritized audit findings across critical, memory, DAX, and AI-readiness categories). - Deep reference library: Twenty-plus reference documents covering relationships, calculation groups, composite models, Direct Lake guardrails, Copilot grounding, security, and performance, plus scripts for model metadata gathering and AI metadata management. - Use Case: Ask the agent to add a measure and set up RLS on a model; it stages the changes with te add, validates with te validate, gates on te bpa run --fail-on error, and saves only when the DAX and referential-integrity checks pass. ## Quick Start Ask the agent to review the semantic model in your workspace for quality and performance issues and produce prioritized findings.

Frequently Asked Questions about semantic-model

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add a measure or relationship to a Power BI semantic model from the command line?▼

Use the te CLI verbs: te add for measures, columns, and relationships (with Fact[Key]->Dim[Key] shorthand), staged in memory until --save. A save-time gate validates DAX and referential integrity, and te validate plus te bpa run confirm the change.

What tool should I use to edit a semantic model: te CLI, TOM, or TMDL?▼

Reach for the narrowest capable tool in order: te CLI first for standard objects, te script (in-process TOM) or connect-pbid for properties te cannot reach like alternateOf or linguistic schema, and fab plus direct TMDL authoring last for service-side or bulk structural operations.

Does this skill work with Direct Lake semantic models?▼

Yes, it covers Direct Lake on OneLake and on SQL, including framing after deploy, DirectQuery fallback triggers, the directLakeBehavior setting, and capacity guardrails. Note the local Desktop proxy cannot reach Direct Lake, so a remote XMLA endpoint is required.

Why does my calculation group show the same number in every scenario column?▼

The row measure carries its own scenario filter, and an inner CALCULATE filter overrides the calculation item's outer filter, so the swap silently does nothing. Write row measures scenario-agnostic and let the calculation item supply the filter.

When should I not use this skill for Power BI work?▼

Do not use it for editing report visuals or pages (use pbir-cli), isolated DAX query performance tuning (use dax-optimisation), TMDL file syntax mechanics (use the tmdl skill), or the te command surface itself (use the te-cli reference skill).

How do I prepare a semantic model for Power BI Copilot?▼

Keep descriptions under 200 characters with front-loaded keywords, add synonyms through the linguistic schema via te script, and configure the AI data schema, verified answers, and AI instructions in the PBIP Copilot folder. Hiding fields does not remove them from Copilot grounding.