tmdl — Claude Code skill: what it does, how to install
Guides direct TMDL file editing and BIM conversions for PBIP semantic models when Tabular Editor CLI or Power BI MCP are unavailable.
GPL-3.0 ★ 1,104 updated 2026-10-28
/plugin marketplace add data-goblin/power-bi-agentic-development
/plugin install pbip@power-bi-agentic-developmentWhat tmdl does
This skill assists with raw TMDL markup inside PBIP project repositories. It explains how to declare measures, tables, and relationships without opening Power BI Desktop. Indentation dictates hierarchy in TMDL; PBIP files use a single tab per level, and mixing tabs with spaces breaks model parsing.
Raw text editing skips DAX syntax checking and referential integrity tests. Syntax mistakes stay hidden until Power BI Desktop parses the files or an XMLA deployment runs. For safer edits, the author suggests checking changes through the pbip-validator agent.
What it helps with
- Modify measure and calculated column declarations directly in
.tmdlfiles - Update metadata attributes such as
formatStringandsummarizeBy - Document fields using triple-slash
///descriptions above object headers - Resolve naming collisions between shared M expressions and table definitions
- Fix whitespace indentation depth according to PBIP tab formatting rules
Example prompts for the agent
- Add a new measure with tab indentation to
tables/Product.tmdl. - Update
summarizeBy: noneon column 'Product Name' and add a triple-slash description. - Convert an existing BIM structure to TMDL definitions and check expression names.
How to install tmdl
1Plugin marketplace
/plugin marketplace add data-goblin/power-bi-agentic-development/plugin install pbip@power-bi-agentic-developmentThis installs the whole pbip plugin with all its skills
2Skills CLI (Vercel)
npx skills add data-goblin/power-bi-agentic-development --skill tmdl -a claude-code3Manually: put the files in place
~/.claude/skills/tmdl/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/tmdl/
1Skills CLI (Vercel)
npx skills add data-goblin/power-bi-agentic-development --skill tmdl -a codex2Manually: put the files in place
.agents/skills/tmdl/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add data-goblin/power-bi-agentic-development --skill tmdl -a cursor2Manually: put the files in place
.cursor/skills/tmdl/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install data-goblin/power-bi-agentic-development plugins/pbip/skills/tmdl2Manually: put the files in place
.github/skills/tmdl/SKILL.md1Skills CLI (Vercel)
npx skills add data-goblin/power-bi-agentic-development --skill tmdl -a gemini-cli2Platform CLI
gemini skills install https://github.com/data-goblin/power-bi-agentic-development --path plugins/pbip/skills/tmdlManually: put the files in place
.devin/skills/tmdl/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 tmdl
How do I install tmdl in Claude Code?
Run /plugin marketplace add data-goblin/power-bi-agentic-development first, then run /plugin install pbip@power-bi-agentic-development.
When should I edit TMDL files directly?
Use direct edits for text-level changes like descriptions or display folders in Git repos when Tabular Editor CLI or MCP tooling is absent.
How do comments and descriptions differ in TMDL?
Lines starting with /// directly set the Description attribute of the immediate next object, whereas standard // lines serve as ignored remarks.