agentleFS
lucaspaesbrazil-lablucaspaesbrazil-lab/agencia-digital-showcase/.claude/skills/dashboard-creator/SKILL.md

dashboard-creator

Skill0 starsChanged 4 months agoMITView on GitHub

Use esta skill SEMPRE que o usuário quiser criar um dashboard de tráfego pago. Ativa com pedidos como 'crie um dashboard', 'quero um dashboard para meu cliente', 'monta um dash de Meta Ads', 'preciso de um painel de resultados', 'dashboard de Google Ads', 'dashboard de tráfego pago' ou qualquer variação. A skill conduz uma entrevista de personalização com 15 perguntas obrigatórias, captura identidade visual via imagem, solicita o ID da planilha Google Sheets, exige o download e anexo da planilha para mapeamento real dos campos e abas, e entrega um arquivo index.html completo e autocontido, pronto para deploy no Netlify via drag and drop e para versionamento em dashboards/[slug-cliente]/.

5 other projects use a version of this.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

2 rules. 0 are common, 0 are distinctive, and 2 are very specific to this project.

  • 0

    Common

    Most of the 5 edited versions we read keep these.

  • 0

    Distinctive

    This author's own choices. Worth a look.

  • 2

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Use também NOME_EMPRESA, NICHO_PRODUTO e PUBLICO para personalizar o cabeçalho do dashboard e enriquecer a narrativa da aba de Análise & …

    line 274
  2. Very specific:

    Mapeie as abas da planilha: use os nomes exatos identificados na P15 — nunca assuma nomes genéricos — Use o TIMEZONE registrado para …

    line 282

“Common” is measured: kept by at least 6 in 10 of the 5 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

SKILL: Dashboard Creator — Tráfego Pago

Objetivo

Automatizar a criação de dashboards analíticos personalizados para agências de marketing digital, com extração de dados via Google Sheets e entrega em HTML/CSS/JS pronto para Netlify.


FLUXO OBRIGATÓRIO

FASE 1 — Entrevista de Personalização (15 perguntas)

Faça uma pergunta por vez. Aguarde a resposta antes de avançar. Não pule etapas.

Antes de começar, diga ao usuário:

"Vou te fazer 15 perguntas para configurar o dashboard do seu cliente. Pode ser direto nas respostas — o que importa é a direção. Vamos lá?"


PERGUNTA 1 — NOME DA EMPRESA

"Qual é o nome da empresa do cliente?"

Este nome será usado no cabeçalho do dashboard e em todos os títulos.

Registre internamente como: NOME_EMPRESA


PERGUNTA 2 — NICHO E PRODUTO

"Qual é o nicho de mercado e o produto ou serviço oferecido?"

Exemplo: "E-commerce de moda feminina", "Clínica odontológica — planos de saúde e implantes", "SaaS B2B — software de gestão para pequenas empresas".

Essa informação orienta o tom da aba de Análise & Insights e contextualiza os benchmarks de performance.

Registre internamente como: NICHO_PRODUTO


PERGUNTA 3 — PÚBLICO-ALVO

"Descreva o público-alvo deste cliente."

Pode ser breve: idade, gênero, interesses, comportamento de compra ou dores principais. Exemplo: "Mulheres 25–45, interessadas em moda e lifestyle, compradoras recorrentes online".

Essa informação enriquece as recomendações da aba de Insights.

Registre internamente como: PUBLICO


PERGUNTA 4 — PLATAFORMAS

Apresente assim ao usuário:

"Quais plataformas estão presentes na base de dados? Digite os números separados por vírgula."

1 — Meta Ads 2 — Google Ads 3 — TikTok Ads 4 — Outra (diga qual)

Exemplo de resposta esperada: "1, 2" ou "1, 3, 4 — LinkedIn Ads"

Cada plataforma selecionada gerará uma aba dedicada no dashboard, lendo de uma sheet separada na planilha Google Sheets.

Registre internamente como: PLATAFORMAS


PERGUNTA 5 — CONTAS POR PLATAFORMA

Apresente assim ao usuário:

"Para cada plataforma, existe mais de uma conta de anúncio? (ex: conta própria + conta de um parceiro/franquia, ou múltiplas contas por unidade/região)"

1 — Não, uma conta por plataforma 2 — Sim (diga quantas contas e um nome curto para cada uma — ex: "2, Conta Própria e Conta Parceiro")

Se houver mais de uma conta:

  • Cada conta vira uma aba de nível superior própria no dashboard (acima da navegação por plataforma/período), com destaque visual claro na aba ativa
  • Pergunte, para cada conta, de qual aba da planilha ela lê os dados — isso será confirmado com precisão na P15, mas registre a expectativa aqui
  • Pergunte também: "As demais funcionalidades (views por tag, budget bar etc.) se aplicam a todas as contas ou só a uma específica?" — isso evita hardcode de nome de conta no código (ver Fase 2, item 7)

Exemplo de resposta esperada: "1" ou "2, Conta Própria e Conta Parceiro — só a Conta Própria tem campanhas com tags"

Registre internamente como: CONTAS_POR_PLATAFORMA


PERGUNTA 6 — AGRUPAMENTO POR TAG

Apresente assim ao usuário:

"As campanhas serão agrupadas por alguma tag no nome?"

1 — Sim 2 — Não

Se sim, pergunte em seguida:

"Quais são as tags? Digite uma por linha ou separadas por vírgula." Exemplo: TOPO, FUNDO, RETARGETING, PROSPECCAO

Cada tag informada gerará uma aba adicional filtrando campanhas cujo nome contenha aquela tag.

Registre internamente como: TAGS


PERGUNTA 7 — MÉTRICAS DE CUSTO

Apresente assim ao usuário:

"Quais métricas de custo devem ser mensuradas? Digite os números separados por vírgula."

1 — CPM (Investimento / Impressões × 1.000) 2 — CPC (Investimento / Cliques) 3 — CPL (Investimento / Leads) 4 — CPMensagem (Investimento / Mensagens iniciadas) 5 — CPA (Investimento / Aquisições ou Conversões) 6 — CPE (Investimento / Engajamento Total) 7 — CPV (Investimento / Thruviews) 8 — Outra (descreva o nome e a fórmula)

Exemplo de resposta esperada: "1, 2, 3" ou "2, 4, 8 — CPSeguidor = Investimento / Seguidores Ganhos"

Registre internamente como: METRICAS_CUSTO


PERGUNTA 8 — MÉTRICAS DE TAXA

Apresente assim ao usuário:

"Quais métricas de taxa devem ser mensuradas? Digite os números separados por vírgula."

1 — % Cliques / CTR (Cliques / Impressões) 2 — % Lead (Leads / Cliques) 3 — % Mensagem (Mensagens / Cliques) 4 — % Conversão (Aquisições ou Conversões / Cliques) 5 — % Engajamento (Engajamento Total / Impressões) 6 — % Views (Thruviews / Impressões)

Exemplo de resposta esperada: "1, 4" ou "1, 2, 3"

Registre internamente como: METRICAS_TAXA


PERGUNTA 9 — ROAS

Apresente assim ao usuário:

"O dashboard deve incluir ROAS (Retorno sobre Investimento em Anúncios)?"

1 — Sim (ROAS = Valor de Compra / Investimento) 2 — Não

Registre internamente como: ROAS


PERGUNTA 10 — KPIs PRINCIPAIS

"Quais são os KPIs principais de performance deste cliente?"

Informe livremente. Exemplo: "CPL abaixo de R$20 e ROAS acima de 3x".

Esses KPIs receberão destaque visual no Overview e serão o foco da aba de Análise & Insights.

Registre internamente como: KPIS


PERGUNTA 11 — IDENTIDADE VISUAL

Apresente assim ao usuário:

"Como vamos definir a identidade visual do dashboard? Você pode combinar mais de uma opção — digite os números separados por vírgula."

1 — Enviar logo ou print do site da marca (anexe o arquivo) 2 — Informar cores manualmente (ex: primária #E91E8C, secundária #1A1A2E) 3 — Minimalista (branco, muito espaço, tipografia fina) 4 — Bold (cores fortes, alto contraste, tipografia pesada) 5 — Corporativo (azul/cinza, sóbrio, formal) 6 — Dark (fundo escuro como base, detalhes vibrantes) 7 — Colorido (paleta variada, visual alegre e dinâmico) 8 — Sem preferência (aplicar design profissional neutro)

Exemplo de resposta esperada: "1, 3" ou "2, 4" ou apenas "8"

A identidade visual será extraída das referências fornecidas e aplicada ao dashboard. Cada dashboard terá um visual único e personalizado.

Registre internamente como: IDENTIDADE_VISUAL


PERGUNTA 12 — RECURSOS ADICIONAIS

Apresente assim ao usuário:

"Deseja incluir algum recurso adicional no dashboard? Digite os números separados por vírgula."

1 — Barra de consumo de verba (investido vs meta planejada para o período) 2 — Alertas de performance (card fica vermelho ⚠️ quando KPI passa do limite) 3 — Filtro por tag direto no Overview (além das abas por tag) 4 — Tabela de melhores anúncios (ranking por KPI principal) 5 — Botão exportar dados como CSV 6 — Sugerir recursos (Claude analisa o contexto e propõe o que faz mais sentido) 7 — Nenhum recurso adicional

Exemplo de resposta esperada: "1, 2" ou "6" ou "7"

Se o usuário selecionar "Sugerir recursos", analise o NICHO_PRODUTO, KPIS e PLATAFORMAS registrados e proponha 3 a 5 recursos adicionais relevantes para aquele contexto específico, justificando cada sugestão. Aguarde confirmação antes de registrar.

Registre internamente como: RECURSOS_ADICIONAIS


PERGUNTA 13 — FUSO HORÁRIO

Apresente assim ao usuário:

"Qual é o fuso horário do cliente?"

1 — Brasília / São Paulo (America/Sao_Paulo — UTC-3) 2 — Manaus / Amazonas (America/Manaus — UTC-4) 3 — Acre (America/Rio_Branco — UTC-5) 4 — Fernando de Noronha (America/Noronha — UTC-2) 5 — Portugal / Lisboa (Europe/Lisbon — UTC+0 / UTC+1 no horário de verão) 6 — Outro (informe o fuso no formato America/Cidade ou UTC±X)

Exemplo de resposta esperada: "1" ou "6 — Europe/Madrid"

⚠️ Esta informação é crítica: define como o dashboard interpreta "hoje", "ontem" e todos os presets de período. Sem o fuso correto, os dados podem aparecer no dia errado.

Registre internamente como: TIMEZONE


PERGUNTA 14 — ID DA PLANILHA

"Qual é o ID da planilha Google Sheets com os dados deste cliente?"

É o código que aparece na URL da planilha, entre /d/ e /edit. Exemplo: https://docs.google.com/spreadsheets/d/**SEU_ID_AQUI**/edit

⚠️ Sem esta informação, o dashboard não poderá ser gerado.

Registre internamente como: SHEETS_ID


PERGUNTA 15 — PLANILHA ANEXADA

"Agora, baixe a planilha Google Sheets e a anexe aqui."

Exporte como .xlsx ou .csv diretamente do Google Sheets em Arquivo → Fazer download.

Com a planilha em mãos, irei:

  • Identificar os nomes exatos das abas (uma por plataforma, ou por conta quando houver mais de uma — ver P5)
  • Mapear os nomes exatos das colunas de cada aba
  • Confirmar quais campos correspondem a cada métrica selecionada
  • Garantir que as fórmulas e os filtros do dashboard referenciem as colunas corretas

⚠️ Esta etapa é obrigatória. Sem o mapeamento real da planilha, o código gerado pode conter referências incorretas que impedirão o dashboard de funcionar.

Registre internamente como: PLANILHA_MAPEADA

Após receber a planilha, inspecione e registre:

  • Lista de todas as abas presentes e seus nomes exatos
  • Nomes exatos de todas as colunas de cada aba
  • Formato dos dados de data (DD/MM/AAAA, AAAA-MM-DD, timestamp etc.)
  • Formato dos valores numéricos (vírgula ou ponto como separador decimal)
  • Nomes reais de campanhas, conjuntos e anúncios (para popular os filtros em cascata)
  • Confirmação de qual aba corresponde a cada conta registrada em CONTAS_POR_PLATAFORMA

Confirme o mapeamento com o usuário antes de avançar para a Fase 2.

Use também NOME_EMPRESA, NICHO_PRODUTO e PUBLICO para personalizar o cabeçalho do dashboard e enriquecer a narrativa da aba de Análise & Insights.


FASE 2 — Planejamento Interno (não exibir ao usuário)

Antes de escrever qualquer código, execute mentalmente:

  1. Mapeie as abas da planilha: use os nomes exatos identificados na P15 — nunca assuma nomes genéricos — Use o TIMEZONE registrado para configurar toda a lógica de datas do dashboard
  2. Classifique cada métrica em seu tipo semântico:
    • CUSTO → CPM, CPC, CPA, CPL, CPE, CPV, Investimento total
    • VOLUME → Impressões, Cliques, Leads, Conversões, Compras, Receita, ROAS, Engajamentos, Views, Add to Cart, View Content
    • TAXA → CTR, Taxa de Conversão, Taxa de Engajamento, Taxa de Views
  3. Defina a lógica de cor para cada métrica com base na classificação:
    • CUSTO subiu → NEGATIVO (vermelho ▼) / caiu → POSITIVO (verde ▲)
    • VOLUME subiu → POSITIVO (verde ▲) / caiu → NEGATIVO (vermelho ▼)
    • TAXA subiu → POSITIVO (verde ▲) / caiu → NEGATIVO (vermelho ▼)
  4. Extraia a identidade visual da imagem enviada: cor primária, cor secundária, estilo (minimalista, bold, dark, light, colorido) e aplique ao design
  5. Planeje a estrutura de abas: Conta (se houver mais de uma, ver P5) → Plataforma → Overview + uma por tag (se houver) + Análise & Insights
  6. Planeje os filtros em cascata: os dropdowns de Campanha → Conjunto → Anúncio devem ser populados dinamicamente a partir dos dados da planilha
  7. Custo por resultado sempre com spend atribuído (regra obrigatória): para qualquer métrica de custo por ação (CPL, CPMensagem, CPA, CPE, CPV etc.), o denominador usa o volume do resultado, mas o numerador usa apenas o spend das linhas/período que geraram aquele resultado especificamente — nunca spend total ÷ resultado total. Isso vale tanto para os cards quanto para os gráficos e tabelas.
    // CORRETO — spend atribuído apenas às linhas com aquele resultado
    let resultado = 0, spendAtribuido = 0;
    rows.forEach(r => {
      const v = n(r['Coluna do Resultado']);
      if (v > 0) { resultado += v; spendAtribuido += n(r['Spend']); }
    });
    const custoPorResultado = resultado > 0 ? spendAtribuido / resultado : 0;
    
    // ERRADO — distorce o custo ao incluir spend de linhas sem aquele resultado
    const custoPorResultado = spendTotal / resultado;
    Se uma mesma linha gerar mais de um tipo de resultado (ex: lead e mensagem no mesmo dia/campanha), o spend dela entra no cálculo de cada métrica de custo separadamente — isso é esperado e deve ser documentado no briefing.md do cliente, não "corrigido" para bater com o spend total.
  8. Nunca hardcode nome de conta/plataforma para decidir visibilidade de seções. Se uma view (ex: abas por tag) só se aplica a uma conta específica (definido na P5), a visibilidade deve ser determinada checando se há dados para aquela combinação (ex: alguma campanha da conta ativa contém a tag) e não por comparação de string fixa como currentAccount === 'CONTA X'. Isso mantém o dashboard funcional se o cliente renomear a conta ou adicionar uma nova.

FASE 3 — Geração do Código

Gere um único arquivo index.html autocontido com a seguinte estrutura obrigatória:


3.1 — Barra Superior

  • Nome do cliente + nome da plataforma ativa
  • Indicador: ● DADOS AO VIVO (GOOGLE SHEETS) com o período ativo exibido
  • Timestamp: Atualizado DD/MM · HH:MM no canto direito
  • Toggle de Dark/Light Mode no canto superior direito (ícone ☀️/🌙)
    • Padrão obrigatório: Light Mode
    • A alternância deve ser suave (transição CSS)
    • O modo selecionado deve persistir durante a sessão e entre reloads, via localStorage — implementação de referência obrigatória (adaptar nomes de classe ao dashboard gerado):
      const THEME_KEY = 'dashboard-theme';
      let isDark = localStorage.getItem(THEME_KEY) === 'dark'; // default: light
      function applyTheme() {
        document.documentElement.classList.toggle('dark', isDark);
        document.getElementById('theme-toggle').classList.toggle('dark-on', isDark);
        document.getElementById('theme-label').textContent = isDark ? 'Modo Claro' : 'Modo Escuro';
      }
      function toggleTheme() {
        isDark = !isDark;
        localStorage.setItem(THEME_KEY, isDark ? 'dark' : 'light');
        applyTheme();
        if (allData.length) updateDashboard(); // re-renderiza gráficos com as cores do novo tema
      }
      applyTheme(); // aplicar antes do primeiro load de dados

3.2 — Navegação por Conta e Plataforma

  • Se houver mais de uma conta por plataforma (P5), renderizar uma aba de nível superior por conta, acima da navegação por plataforma
  • Abaixo (ou no mesmo nível, se só houver uma conta), abas para alternar entre plataformas (uma por plataforma selecionada na P4)
  • A aba ativa (de conta e de plataforma) deve ter destaque visual claro
  • Trocar de conta deve recarregar os dados da aba correta da planilha (conforme mapeamento da P15) e resetar a view ativa para Overview

3.3 — Filtros de Período

  • Pílulas clicáveis: Hoje · Ontem · 7 dias · 14 dias · 28 dias · Este mês · Mês passado · Este ano · Personalizado
  • A pílula ativa deve ter destaque visual com a cor primária da marca
  • "Personalizado" abre campos de data início e data fim

3.4 — Filtros em Cascata

Três dropdowns obrigatórios em todas as abas:

  • Campanha → padrão: "Todas as campanhas"
  • Conjunto de anúncios → padrão: "Todos os conjuntos" (restringe com base na campanha selecionada)
  • Anúncio → padrão: "Todos os anúncios" (restringe com base no conjunto selecionado)

Os três filtros devem funcionar em cascata: seleção superior restringe opções inferiores. Todos os cards e gráficos devem atualizar reativamente.


3.5 — Overview: Cards de Big Numbers

  • Um card por métrica selecionada na P3
  • Cada card exibe: nome da métrica + valor atual + variação % vs período anterior
  • A variação deve seguir rigorosamente a Regra Semântica de Cores definida na Fase 2
  • Formato da variação: ▲ 74,48% vs ant. (verde) ou ▼ 4,75% vs ant. (vermelho)
  • Os KPIs principais (P4) devem ter destaque visual diferenciado nos cards

3.6 — Gráfico Combinado de Evolução

  • Colunas: volume do resultado principal (definido pelos KPIs da P4)
  • Linha sobreposta: custo por resultado correspondente
  • Filtro de granularidade: por dia / por semana / por mês
  • Deve respeitar os filtros de período e cascata ativos
  • Gerado com Chart.js via CDN

3.7 — Tabela de Campanhas

Logo abaixo do gráfico de evolução, exibir uma tabela com a relação de todas as campanhas ativas no período selecionado e seus respectivos resultados.

Estrutura obrigatória da tabela:

  • Coluna 1: Nome da campanha
  • Colunas seguintes: uma coluna por métrica selecionada na P6 (ex: Investimento, Impressões, Cliques, CTR, CPL etc.)
  • Última coluna: variação % do KPI principal vs período anterior, com cor semântica (verde/vermelho conforme regra de CUSTO/VOLUME/TAXA)

Comportamento:

  • A tabela deve respeitar todos os filtros ativos (período + cascata de conjunto e anúncio)
  • Ordenação padrão: pela métrica do KPI principal (decrescente)
  • Clicar no cabeçalho de qualquer coluna ordena a tabela por aquela métrica
  • Linhas com performance positiva vs período anterior recebem sutil destaque visual
  • A tabela deve ser responsiva e ter scroll horizontal em telas menores

3.8 — Abas por Tag (se aplicável)

  • Uma aba por tag informada na P6
  • Filtra dinamicamente campanhas cujo nome contenha a tag
  • Exibe os mesmos cards e gráfico da aba Overview, filtrados pela tag
  • Se as tags se aplicam apenas a uma conta específica (registrado na P5), a visibilidade dessas abas deve ser decidida checando se a conta ativa tem campanhas com aquela tag nos dados carregados — nunca por comparação hardcoded do nome da conta (ver Fase 2, item 8)

3.9 — Aba de Análise & Insights

  • Gerada automaticamente a partir dos dados carregados
  • Estrutura obrigatória:
    • Resumo executivo: narrativa curta do período (3–4 linhas)
    • O que melhorou: métricas com variação positiva + hipótese do motivo
    • O que piorou: métricas com variação negativa + hipótese do motivo
    • Recomendações: 3 a 5 ações concretas para melhorar os KPIs nas próximas semanas
  • A análise deve ser orientada pelos KPIs principais definidos na P10

3.10 — Conexão com Google Sheets

  • Usar a URL pública de exportação CSV do Google Sheets: https://docs.google.com/spreadsheets/d/{SHEETS_ID}/gviz/tq?tqx=out:csv&sheet={NOME_DA_ABA}
  • Uma requisição por aba/plataforma/conta
  • Os dados são carregados no DOMContentLoaded e re-carregados a cada mudança de filtro
  • Exibir loading state enquanto os dados são carregados

Lógica de fuso horário — obrigatória:

  • Declarar a constante TIMEZONE no topo do JS com o valor registrado na P13 ex: const TIMEZONE = 'America/Sao_Paulo';
  • Toda data calculada no dashboard (hoje, ontem, início/fim de mês, início/fim de ano etc.) deve ser derivada de um helper que ancora no fuso do cliente — nunca new Date() cru (que reflete o fuso do navegador de quem está vendo o dashboard, não o do cliente). Implementação de referência:
    const TIMEZONE = 'America/Sao_Paulo'; // valor da P13
    
    // Retorna um Date cujos getFullYear/getMonth/getDate/getHours refletem o
    // horário local em TIMEZONE, independente do fuso do navegador do usuário.
    function nowInTZ(timezone = TIMEZONE) {
      const parts = new Intl.DateTimeFormat('en-US', {
        timeZone: timezone,
        year: 'numeric', month: '2-digit', day: '2-digit',
        hour: '2-digit', minute: '2-digit', second: '2-digit',
        hour12: false
      }).formatToParts(new Date());
      const get = type => parts.find(p => p.type === type).value;
      return new Date(
        +get('year'), +get('month') - 1, +get('day'),
        +get('hour') === 24 ? 0 : +get('hour'), +get('minute'), +get('second')
      );
    }
    Usar nowInTZ() em todo lugar que hoje usaria new Date() para montar "hoje", "ontem", presets de período e o timestamp da barra superior.
  • Os dados da planilha devem ter suas datas parseadas e comparadas já ajustadas ao mesmo fuso
  • O timestamp "Atualizado DD/MM · HH:MM" na barra superior deve refletir o horário local do fuso do cliente, não do navegador do usuário

3.11 — Requisitos Técnicos

  • Um único arquivo index.html autocontido
  • CSS em bloco <style> com identidade visual da marca aplicada
  • JS em bloco <script> — sem frameworks externos, apenas Chart.js via CDN
  • Sem necessidade de build, servidor ou backend
  • Pronto para Netlify drag and drop — basta arrastar o arquivo para app.netlify.com/drop
  • Dark/Light Mode implementado via classes CSS no <body> (class="light" como padrão) e persistido via localStorage (ver snippet obrigatório em 3.1)
    • Todas as cores do dashboard devem ter variante definida para os dois modos
    • A troca de modo deve atualizar os gráficos Chart.js (cores de fundo, texto, grid)
  • Encoding sempre UTF-8 puro — nunca gerar ou copiar conteúdo que resulte em caracteres corrompidos (mojibake, ex: "é" no lugar de "é"). Se o conteúdo vier de uma fonte externa colada pelo usuário, verificar visualmente caracteres acentuados antes de incorporar ao arquivo final.
  • Responsivo — obrigatório para mobile e desktop:
    • Layout baseado em CSS Grid e/ou Flexbox com breakpoints definidos
    • Mobile (< 768px): cards empilhados em coluna única, gráfico em altura reduzida, tabela com scroll horizontal, filtros de período em scroll horizontal (pílulas), dropdowns de cascata empilhados verticalmente, navegação de abas em scroll horizontal
    • Tablet (768px–1199px): cards em grid de 2–3 colunas, demais elementos adaptados
    • Desktop (≥ 1200px): layout completo com cards em grid de 4–6 colunas
    • Nenhum elemento deve ultrapassar a largura da tela em nenhum breakpoint
    • Fonte e espaçamentos devem ser legíveis em telas pequenas (mínimo 14px no mobile)

FASE 4 — Revisão Interna (não exibir ao usuário)

Antes de entregar, verifique:

ItemVerificação
Fuso horárioConstante TIMEZONE declarada? Todos os cálculos de data usam nowInTZ() (ou equivalente ancorado no fuso do cliente)? Timestamp na barra superior no horário certo?
ContasSe houver mais de uma conta por plataforma (P5), há aba de nível superior por conta? A visibilidade de views condicionadas a uma conta específica é decidida por dados, não por nome hardcoded?
Filtros de períodoTodos os 9 presets presentes + opção personalizado funcional?
Filtros em cascataCampanha → Conjunto → Anúncio reativos e interdependentes?
CardsTodos as métricas selecionadas presentes com variação % e cor semântica correta?
Custo por resultadoCPL/CPA/CPMensagem/CPE/CPV usam spend atribuído (apenas linhas com aquele resultado), nunca spend total ÷ resultado total?
GráficoColunas + linha sobrepostos com filtro de granularidade?
Tabela de campanhasPresente logo abaixo do gráfico? Ordenável por coluna? Métricas + variação % com cor semântica?
Filtros cascataDropdowns exibem apenas itens com dados no período ativo? Repovoam ao trocar período?
AbasConta (se houver) → Plataforma → Overview + uma por tag (se houver) + Análise & Insights?
InsightsResumo + melhorias + pioras + recomendações presentes?
VisualIdentidade da marca aplicada? Design único e não genérico?
TécnicoArquivo único? Sem dependências locais? Chart.js via CDN?
EncodingUTF-8 puro, sem caracteres corrompidos (mojibake)?
Dark/Light ModeToggle presente na barra superior? Padrão em Light Mode? Persiste via localStorage entre reloads? Ambos os modos com cores definidas?
ResponsivoLayout adaptado para mobile (< 768px), tablet e desktop? Nenhum elemento ultrapassa a tela?
Recursos adicionaisTodos os recursos selecionados em RECURSOS_ADICIONAIS foram implementados?
SheetsID da planilha corretamente inserido nas URLs de fetch, uma por conta/aba mapeada?
ColunasOs nomes das colunas no código batem com os nomes reais da planilha (mapeados na P15)?
AbasOs nomes das sheets no código batem com os nomes reais das abas (mapeados na P15)?

Se algum item falhar, corrija antes de entregar.


FASE 5 — Entrega Final

Apresente o resultado ao usuário assim:


✅ Dashboard gerado com sucesso!

[Arquivo index.html completo]


📋 Instruções de deploy:

  1. Acesse app.netlify.com/drop
  2. Arraste o arquivo index.html para a área indicada
  3. O dashboard estará no ar em segundos com uma URL pública

⚙️ Antes de publicar, certifique-se de que:

  • A planilha Google Sheets está com acesso público ("Qualquer pessoa com o link pode visualizar")
  • As abas da planilha têm os nomes exatos usados no código (exibidos nos comentários do JS)

🔄 Para atualizar os dados:

  • Basta atualizar a planilha — o dashboard puxa os dados em tempo real a cada carregamento

FASE 5-B — Salvar no Repositório (sempre, além da entrega ao usuário)

Depois de entregar o arquivo ao usuário, salve o trabalho dentro do projeto:

  1. Criar (se ainda não existir) a pasta dashboards/[slug-cliente]/ — slug em kebab-case a partir de NOME_EMPRESA
  2. Salvar o arquivo final em dashboards/[slug-cliente]/index.html
  3. Salvar um dashboards/[slug-cliente]/briefing.md com as respostas das 15 perguntas (NOME_EMPRESA, NICHO_PRODUTO, PUBLICO, PLATAFORMAS, CONTAS_POR_PLATAFORMA, TAGS, METRICAS_CUSTO, METRICAS_TAXA, ROAS, KPIS, IDENTIDADE_VISUAL, RECURSOS_ADICIONAIS, TIMEZONE, SHEETS_ID, e o resumo do mapeamento de abas/colunas da P15)
  4. Se o cliente já existir em clients/[slug-cliente]/, referenciar a existência do dashboard no profile.md dele; se ainda não existir pasta de cliente, sugerir ao usuário criá-la a partir de clients/_template/
  5. Depois que o usuário confirmar o deploy no Netlify, perguntar a URL pública gerada e registrá-la no profile.md do cliente

Ver dashboards/README.md para a convenção completa da pasta.


REGRAS GERAIS DA SKILL

  • Faça uma pergunta por vez — nunca agrupe
  • Nunca gere o código antes de coletar todas as 15 respostas
  • Se o SHEETS_ID não for fornecido, não gere o código — solicite novamente
  • Se a planilha não for anexada na P15, não gere o código — é impossível garantir referências corretas sem o mapeamento real dos campos
  • Se nenhuma imagem for enviada na P11, aplique um design profissional neutro (dark ou light)
  • A identidade visual deve ser única por cliente — nunca use o mesmo esquema de cores
  • Os filtros em cascata devem ser sempre reativos — nenhum card ou gráfico pode ficar estático
  • A aba de Análise & Insights deve ser sempre gerada — nunca é opcional
  • O arquivo entregue deve ser sempre autocontido — sem dependências de arquivos externos
  • O fuso horário do cliente deve ser sempre declarado explicitamente no JS e usado via helper ancorado no fuso (ver 3.10) — nunca assumir UTC ou o fuso do navegador
  • O custo por resultado (CPL, CPA, CPMensagem, CPE, CPV) deve sempre usar spend atribuído apenas às linhas que geraram aquele resultado — nunca spend total dividido pelo resultado total (ver Fase 2, item 7)
  • A visibilidade de qualquer seção condicionada a uma conta/plataforma específica deve ser sempre decidida por dados, nunca por comparação hardcoded de nome (ver Fase 2, item 8)
  • O dashboard deve ser sempre iniciado em Light Mode — nunca em Dark Mode, independente da preferência do sistema do usuário — e a escolha do usuário deve persistir entre reloads via localStorage
  • O dashboard deve ser sempre responsivo — mobile e desktop são obrigatórios, nunca entregar layout fixo
  • O arquivo final deve sempre ser salvo em dashboards/[slug-cliente]/ além de entregue ao usuário (ver Fase 5-B)

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.