# tmdl

Guides direct TMDL file editing and BIM conversions for PBIP semantic models when Tabular Editor CLI or Power BI MCP are unavailable.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 1104 repo stars
- Author: Kurt Buhler
- License: GPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/data-goblin/power-bi-agentic-development/tree/HEAD/plugins/pbip/skills/tmdl/SKILL.md
- Updated: 2026-10-28
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/tmdl

## What it 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.

## Requirements
- Works with: Power BI

## Install

### Claude Code (native platform)

1. **Plugin marketplace**
In the agent chat (not a shell):
```text
/plugin marketplace add data-goblin/power-bi-agentic-development
```
In the agent chat (not a shell):
```text
/plugin install pbip@power-bi-agentic-development
```
This installs the whole pbip plugin with all its skills

2. **Skills CLI (Vercel)**
```bash
npx skills add data-goblin/power-bi-agentic-development --skill tmdl -a claude-code
```

3. **Manually: put the files in place**
- File: `~/.claude/skills/tmdl/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/tmdl/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add data-goblin/power-bi-agentic-development --skill tmdl -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/tmdl/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add data-goblin/power-bi-agentic-development --skill tmdl -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/tmdl/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install data-goblin/power-bi-agentic-development plugins/pbip/skills/tmdl
```

2. **Manually: put the files in place**
- File: `.github/skills/tmdl/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add data-goblin/power-bi-agentic-development --skill tmdl -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/data-goblin/power-bi-agentic-development --path plugins/pbip/skills/tmdl
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/tmdl/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/data-goblin/power-bi-agentic-development/tree/HEAD/plugins/pbip/skills/tmdl/SKILL.md

## When to use it
- Modify measure and calculated column declarations directly in `.tmdl` files
- Update metadata attributes such as `formatString` and `summarizeBy`
- 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
- Add a new measure with tab indentation to `tables/Product.tmdl`.
- Update `summarizeBy: none` on column 'Product Name' and add a triple-slash description.
- Convert an existing BIM structure to TMDL definitions and check expression names.

## Similar
- [Horizun PBI MCP](https://affpapa.org/en/nevibecode/mcp/horizun-pbi-mcp.md) — MCP server · ★ 34 repo stars
- [Power BI Authoring MCP Server (Local)](https://affpapa.org/en/nevibecode/mcp/power-bi-authoring-mcp-server-local.md) — MCP server · ★ 1297 repo stars
- [powerbi-modeling](https://affpapa.org/en/nevibecode/skills/powerbi-modeling.md) — skill · 9934 installs
- [power-bi-dax-optimization](https://affpapa.org/en/nevibecode/skills/power-bi-dax-optimization.md) — skill · 9100 installs
- [power-bi-retail-analytics-salespulse360](https://affpapa.org/en/nevibecode/skills/power-bi-retail-analytics-salespulse360.md) — skill · 659 installs
- [power-bi-salespulse-dashboard](https://affpapa.org/en/nevibecode/skills/power-bi-salespulse-dashboard.md) — skill · 658 installs

From the same set: [data-goblin/power-bi-agentic-development](https://affpapa.org/en/nevibecode/by/data-goblin/power-bi-agentic-development.md) — 59 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
