How to use
- Copy the installation command and review the source package before installing it in your own agent environment.
- Check the source document for required tools, credentials and supported hosts.
- Describe your input and desired deliverable; review the output against the source material.
npx skills add https://github.com/officetuning/skill-library --skill powerbi-visuaisBefore you start
- Installation does not include a model subscription, API allowance or permission to access your files.
- Repository stars and installation counts describe activity, not an independent quality or security test.
Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.
Visuais no Power BI
Pergunta central
O que eu quero que o usuário conclua ao olhar para isso?
O visual serve à conclusão. Antes de sugerir qualquer visual, responda as cinco dimensões:
| Dimensão | Pergunta |
|---|---|
| Objetivo | Comparar, tendência, proporção, correlação, progresso vs meta ou causa? |
| Tipo de dado | Categórico, numérico, temporal, geográfico, hierárquico? |
| Audiência | Executivo (síntese), analista (exploração), operador (monitoramento)? |
| Espaço | KPI em célula pequena ou área ampla? |
| Interatividade | Leitura passiva ou exploração com drill e filtro? |
Regras
Obrigatório
- Classifique a pergunta analítica antes de sugerir o visual.
- Justifique pela percepção: posição > comprimento > inclinação > ângulo >
área > cor. Nunca "fica bonito".
- Limites: pizza ≤ 4 fatias · linhas ≤ 5 séries · barras ≤ 12–15 categorias ·
cascata ≤ 12 etapas.
- Barras sempre com base zero. Rótulo de dado ativo → eixo de valor e grade desligados.
- Cor só com significado. Teste para daltonismo.
Preferir
- Barras horizontais ordenadas no lugar de pizza, rosca e gauge.
- Visual KPI em vez de gauge; cartão só quando não há meta.
- Formatação condicional por limite de negócio, não estatístico.
- Tooltip page de 400×304 px (padrão do ecossistema OfficeTuning, múltiplo
de 8; o padrão genérico do Power BI é 320×240).
- Small multiples quando a pergunta é "o padrão se repete entre categorias?".
- Linha de meta ou média pelo painel de Análise.
- Árvore de Decomposição para causa raiz; Principais Influenciadores para "o que explica?".
Evitar
- Eixo truncado em barras, 3D, arco-íris em dado ordenado, empilhado com mais
de 3 séries, mais de uma linha sobre colunas em combo.
- Mapa só porque existe campo geográfico. Use mapa quando a geografia é o insight.
- Visual Q&A: a Microsoft anunciou a descontinuação (remoção prevista para
dez/2026 na data desta base). Indique Copilot. Confirme o status na documentação antes de afirmar datas.
Referência rápida
| Visual | Use quando | Evite quando | Substituto |
|---|---|---|---|
| Barras/Colunas | Comparar categorias | > 12 categorias | Tabela ordenada |
| Linha | Tendência temporal contínua | Dado sem relação temporal | Barras ordenadas |
| Área | Magnitude da mudança | > 3 séries | Linha |
| Combo | Duas métricas, escalas diferentes | Métricas sem relação | Dois visuais |
| Faixa (Ribbon) | Mudança de ranking | Valor absoluto importa mais | Barras empilhadas |
| Cascata | Decompor variação | > 12 etapas | Barras com cor |
| Pizza/Rosca | ≤ 4 fatias, proporção dominante | > 4 fatias | Barras horizontais |
| Treemap | Hierarquia, proporção relativa | Valores próximos | Barras |
| Funil | Processo sequencial | Sem sequência | Barras |
| Dispersão | Correlação entre duas variáveis | Dado categórico | Dot plot |
| Tabela | Valor exato, várias unidades | Tendência é o insight | Linha |
| Matriz | Multidimensional com hierarquia | Uma dimensão só | Tabela |
| Cartão | Um KPI sem meta | Há meta ou contexto temporal | KPI |
| KPI | Valor + meta + tendência | Sem meta | Cartão |
| Gauge | Operação ao vivo, audiência leiga | Pouco espaço, vários KPIs | KPI |
| Decomposição | Causa raiz | Exploração simples | Filtro + barras |
| Principais Influenciadores | O que explica um resultado | Pouca variação nos dados | Dispersão + segmentação |
| Narrativa Inteligente | Resumo automático | Texto precisa ser exato | Caixa de texto + DAX |
Detalhe de configuração de cada visual, segmentação, navegação e recursos transversais: references/catalogo-visuais.md.
Visual gerado por DAX (SVG/HTML)
Visual nativo primeiro. SVG e HTML entram só quando formatação condicional ou KPI nativo não resolvem.
⚠️ Locale pt-BR: atributos numéricos de SVG exigem ponto decimal. Force sempre:
SUBSTITUTE ( FORMAT ( vValor, "0.00" ), ",", "." )Padrões prontos (barra de progresso, sparkline, narrativa HTML), armadilhas e checklist: references/svg-html-dax.md.
Temas
Consistência de cor e fonte vem do tema .json do relatório, não de formatação visual por visual. Não gere tema, paleta ou ícone à mão: indique o Background Builder, que exporta o tema junto com os fundos (skill dashboard-layout). Gere à mão só se o usuário insistir.
Docs: Temas de relatório
