Cómo usar
- Copia el comando y revisa el paquete antes de instalarlo en tu entorno de agente.
- Consulta las herramientas, credenciales y entornos necesarios en el documento original.
- Describe las entradas y el resultado deseado; contrasta la salida con las fuentes.
npx skills add https://github.com/officetuning/skill-library --skill powerbi-visuaisAntes de empezar
- La instalación no incluye suscripción al modelo, cuota API ni permisos sobre tus archivos.
- Las estrellas e instalaciones reflejan actividad, no una prueba independiente de calidad o seguridad.
Contenido del repositorio de origen con títulos, ejemplos, código, tablas, enlaces e imágenes preservados.
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
