---
name: pbi-dax-create
description: Cria medida DAX a partir de descrição em PT, respeitando o modelo Power BI existente (colunas reais, naming convention, padrões DAX). Use quando o usuário pedir "cria medida pra X", "preciso de DAX que faça Y", "quero calcular Z", "uma fórmula pra...", ou qualquer pedido pra gerar nova medida em projeto PBIP aberto.
---

# /pbi-dax-create — Criação de medida DAX

> **📦 Distribuída publicamente:** [github.com/xperiun/claude-code-powerbi-skills](https://github.com/xperiun/claude-code-powerbi-skills) — pasta `claude-code/pbi-dax-create/` (skill nativa) + `claude-web/pbi-dax-create.zip` (upload no Claude.ai). Mudança aqui exige sincronizar lá: atualizar pasta + regenerar ZIP (Python `zipfile`, ver CLAUDE.md) + commit + bump CHANGELOG. Repo é open-source, leiame público — evitar referências internas (Xperiun-only) na SKILL.md.

Gera medidas DAX a partir de descrição em linguagem natural, **respeitando o modelo existente**:
- Usa as colunas e tabelas que **realmente existem** (sem inventar)
- Detecta o **padrão de nomenclatura** do projeto (Title Case, camelCase, com prefixos, etc.) e segue
- Aplica **boas práticas DAX** automaticamente (DIVIDE em vez de /, SUMX vs SUM correto, time intelligence apropriado)
- Avisa se a medida pedida **já existe** ou tem similar parecida
- Faz **pergunta clarificadora** quando o pedido é ambíguo

**Output principal**: medida DAX no chat com nome, fórmula completa, explicação linha-a-linha e onde colar. **Opcional**: aplica direto no `.tmdl` (com aprovação explícita).

## Quando usar

- Analista que sabe o que quer mas quer pular o "digitar DAX no editor"
- Líder de dados criando medidas em batch sem abrir Power BI Desktop
- Refatorando uma medida pra padrão DAX recomendado
- Onboarding: aprendiz descreve em PT e a skill mostra a forma correta

**Não usar quando:**
- Quer documentar medidas existentes → use `/pbi-doc`
- Quer auditar qualidade de modelo → use `/pbi-modelo-review`
- Quer refatorar medidas existentes em batch (skill futura `/pbi-dax-refactor`)
- Quer apenas explicar um DAX que já existe (use `/pbi-doc` que tem isso)

## Pré-requisitos

1. **Projeto em formato PBIP** (Power BI Project) — pasta com `.SemanticModel/`. Se faltar, instruir conversão e encerrar.
2. Acesso aos arquivos `.tmdl` (via filesystem ou upload — ver "Modos de execução" abaixo)

Se faltar PBIP, mensagem curta:
> Esse projeto ainda está em `.pbix` (binário). Pra eu criar medidas com base no modelo real, salva como Power BI Project: `File → Save as → Power BI Project (.pbip)`. Sem isso eu não consigo ler colunas/medidas existentes pra te dar uma medida que funciona.

## Modos de execução

A skill detecta automaticamente o ambiente e adapta input/output:

### Modo Code (Claude Code · Desktop · file-based)
- **Detecção**: tenho acesso a filesystem e a pasta atual contém `.SemanticModel/`
- **Input**: leio automaticamente os `.tmdl` da pasta
- **Output**: medida no chat. Se aprovado, **edito direto** o `.tmdl` da tabela host

### Modo Web (Claude.ai · upload-based)
- **Detecção**: não tenho acesso a filesystem (claude.ai web)
- **Input**: peço ao usuário pra anexar os arquivos:
  > Pra eu criar uma medida que funciona com o seu modelo real, anexe nesse chat:
  > - `model.tmdl` (lista geral de tabelas)
  > - O `.tmdl` da tabela onde a medida vai ficar (ex: `Medidas.tmdl`)
  > - Se a medida vai usar colunas/medidas de outras tabelas, anexa também esses `.tmdl`
  >
  > Pode arrastar individualmente ou zipar tudo num arquivo só.
- **Output**: medida no chat (3 nomes + DAX + explicação + onde colar). Como não posso editar arquivo direto no web, devolvo o **bloco TMDL pronto** pra usuário copiar e colar manualmente no arquivo (ou no Power BI Desktop).

### Detecção automática

Verificar se a pasta `.SemanticModel/` é acessível via filesystem:
- ✅ Sim → Modo Code (file-based, edição direta possível)
- ❌ Não → Modo Web (peço uploads, devolvo bloco pra copiar)

Se ambíguo, perguntar uma vez:
> Você tá rodando isso no **Claude Code** (CLI/IDE com acesso à pasta) ou no **claude.ai** (web)? Pra Code eu posso editar o `.tmdl` direto; pra web você precisa colar o bloco que eu te mando.

## Inputs

- **Descrição em PT** (obrigatório) — o que a medida deve calcular
- **(Opcional) Tabela host** — onde colocar. Default: tabela `Medidas` se existir, senão pergunta

Se descrição for vaga ou ambígua (ex: "vendas totais" — bruto ou líquido?), **fazer 1 pergunta clarificadora antes** de gerar.

## Processo

### 1. Detectar e mapear o modelo

- Confirmar `.SemanticModel/`
- Ler `model.tmdl` (config), `relationships.tmdl`, `tables/*.tmdl`
- Ignorar `LocalDateTable_*` e `DateTableTemplate_*` (auto-date hidden)
- Inventariar:
  - Tabelas (e qual delas é "Medidas" container, se existir)
  - Todas as colunas tipadas (qual tabela, tipo, papel inferido)
  - Todas as medidas existentes (nome, DAX, displayFolder)
  - Padrão de naming detectado nas medidas (ver `references/padroes.md`)

### 2. Interpretar a solicitação

Da descrição em PT, identificar:
- **Tipo de cálculo**: agregação simples (soma/média/contagem), divisão (%, ratio), comparação temporal (YoY, MTD, YTD), ranking, filtro condicional, lógica IF/SWITCH
- **Colunas/medidas necessárias**: tem que existir no modelo. Se a descrição menciona algo que não existe → sugerir alternativas reais
- **Granularidade implícita**: se "total" provavelmente quer SUM/SUMX, se "média" AVERAGE, se "único/distintos" DISTINCTCOUNT, etc.

**Se ambíguo**, parar e perguntar (1 pergunta única, objetiva). Exemplos:
- "vendas totais" → "Total de qual coisa? (a) Receita bruta com SUMX(Vendas, Qtd × Preço), (b) Receita líquida com algum desconto/devolução, (c) Quantidade total de itens vendidos"
- "% de margem" → "Sobre o quê? (a) Margem Bruta / Faturamento, (b) Margem Líquida / Receita Líquida"

### 3. Aplicar padrões DAX

Ler `references/padroes.md` e seguir as regras:
- `DIVIDE(num, den)` em vez de `num / den` (evita ∞ e erros silenciosos)
- `SUMX(tabela, expressão)` quando expressão envolve mais de 1 coluna por linha
- `SUM(tabela[col])` quando é soma simples de 1 coluna
- `DISTINCTCOUNT()` em coluna inteira (key) quando possível
- Time intelligence (`SAMEPERIODLASTYEAR`, `DATEADD`, `DATESYTD`) sempre referenciando coluna de tabela calendário
- `CALCULATE` com filter modifier explícito quando precisa modificar contexto
- `VAR ... RETURN` pra medidas com 3+ passos lógicos (legibilidade)

### 4. Aplicar padrão de nomenclatura

Detectar o padrão usado nas medidas existentes do projeto (ver `references/padroes.md` seção naming):
- **Title Case PT** (`Total Vendas`, `% Margem Bruta`)
- **Prefixo de tipo** (`% Faturamento YoY`, `# Pedidos`, `Δ MoM`)
- **camelCase** (`totalVendas`)
- **Mistura** (sinalizar que tá inconsistente, sugerir o mais comum)

Sempre gerar 3 sugestões de nome seguindo o padrão dominante.

### 5. Gerar a medida

Verificar antes de retornar:
- ✅ Todas as colunas/medidas referenciadas existem no modelo
- ✅ DAX segue boas práticas
- ✅ Nome segue padrão do projeto
- ⚠️ Existe medida similar no modelo? (busca por nome parecido OU mesma fórmula) → avisar antes de duplicar

### 6. Retornar no chat

Usar o formato definido em `templates/output-medida.md`. Resposta:
- 3 sugestões de nome (1ª recomendada, com justificativa)
- DAX completo formatado
- Explicação linha-a-linha em PT
- Onde colar (qual `.tmdl`, em qual seção/displayFolder)
- displayFolder sugerido (se aplicável)

### 7. Aplicação opcional

Ao final, perguntar:
> Quer que eu **aplique direto** no `Medidas.tmdl` (vou editar o arquivo) ou prefere **só copiar** e colar no Power BI manualmente?

**Default seguro**: só mostra. Aplica direto somente se o usuário disser sim explicitamente.

Se aplicar:
- Localizar a tabela host no `.tmdl`
- Inserir a medida na seção correta (alfabética dentro do displayFolder)
- Adicionar `description:` opcional se útil
- Salvar
- **Não commita** (regra inviolável git do CLAUDE.md raiz)

## Outputs

**Modo padrão** (só sugere):
- Resposta no chat com nome + DAX + explicação + instruções de colar
- Nenhum arquivo modificado

**Modo aplicar** (com aprovação explícita):
- `.tmdl` da tabela host modificado (medida inserida)
- Resumo curto no chat: "Medida X adicionada em Medidas.tmdl, linha Y"

## Edge cases

| Cenário | O que fazer |
|---|---|
| Descrição muito vaga | 1 pergunta clarificadora antes de gerar |
| Coluna pedida não existe | Sugerir as 2-3 colunas reais mais próximas + perguntar qual |
| Medida pedida já existe (mesmo nome) | Avisar e perguntar: substituir ou criar com nome diferente? |
| Medida com fórmula similar já existe | Avisar e mostrar a existente — perguntar se é o que ele quer ou se realmente quer criar nova |
| Sem tabela "Medidas" no modelo | Listar tabelas e perguntar onde colocar (ou sugerir criar tabela vazia "Medidas") |
| Time intelligence sem dim Calendario marcada | Avisar limitação + criar a medida mas sinalizar que pode dar resultado errado |
| Modelo enorme (>500 medidas) | Carregar só nomes+DAX-essência das existentes (não DAX completo) pra evitar contexto explodir |

## Tom

Estilo Xperiun:
- **Direto**: vai pra fórmula sem rodeio teórico
- **Didático mas não condescendente**: explica linha-a-linha em PT, mas no nível de quem já sabe DAX
- **Provocativo quando útil**: se o pedido tem antipattern óbvio, sinaliza ("você quer SUMX direto em fato de 5M linhas? Pode dar trabalho — alternativa: ...")
- **PT-BR com todos os acentos** (regra inviolável CLAUDE.md)

Exemplos:

❌ Ruim: "Para calcular o faturamento, podemos utilizar a função SUMX que iterará..."

✅ Bom: "**Faturamento** — SUMX em fVendas multiplicando QtdItens × PrecoUnitario. Mais limpo que coluna calculada (que infla a fato)."

## Segurança / Blast radius

- **Lê** arquivos `.tmdl` (texto puro)
- **Modo padrão**: zero modificação no projeto
- **Modo aplicar**: edita só o `.tmdl` da tabela host, nunca toca outros
- **NÃO commita** (segue regra inviolável git)
- **NÃO faz rede** — operação 100% local

## Tom dos avisos sobre risco

Quando aplicar direto:
- Antes: "Vou editar `Medidas.tmdl` e adicionar a medida na seção `0. Medidas Padrão`. Pode?"
- Após: "Adicionada. Abre o Power BI Desktop e ele vai recarregar o modelo automaticamente. Se quiser desfazer, só rodar `git diff` e descartar."

## Tempo típico

- Medida simples (agregação ou divisão): **15–30s**
- Medida com time intelligence ou múltiplos VAR: **30–60s**
- Medida que requer pergunta clarificadora: **+ tempo de ida-e-volta** com você

## Versão

`v0.1` — protótipo interno Xperiun OS. Faz parte do trio do lead magnet (`/pbi-modelo-review` · `/pbi-doc` · `/pbi-dax-create`).