📊 Skill Spec

Analytics Dashboard

Spec genérica para skills que consolidam métricas de múltiplas fontes, geram relatórios e distribuem análises recorrentes.

Spec GenéricaMétricas multi-fonteDashboardRelatórios

1. Objetivo da Skill

Coletar dados de canais, campanhas ou produtos, consolidar indicadores relevantes e entregar relatórios analíticos com leituras comparativas e histórico.

2. Contrato de Entrada e Saída

Entradas

fontes de métricas e credenciais
periodicidade e janelas de comparação
métricas obrigatórias e opcionais
canais ou repositórios de destino

Saídas

relatórios estruturados
tabelas, resumos ou dashboards
sinais de alerta ou insights
opcionalmente arquivos CSV, JSON ou imagens

3. Fluxo Canônico

Coleta: Buscar métricas nas fontes configuradas e normalizar os dados.
Consolidação: Combinar dados de períodos, canais e campanhas em um modelo comum.
Análise: Calcular variações, detectar anomalias e destacar insights relevantes.
Formatação: Gerar o relatório nos formatos exigidos pela instalação.
Entrega: Enviar, salvar ou publicar o output com logging e histórico.

4. Pontos de Adaptação

as fontes podem ser APIs sociais, bancos, planilhas, data warehouses ou arquivos
o output pode ser texto, HTML, dashboard ou arquivo analítico
a análise pode ser simples ou distribuída em especialistas por domínio
a skill pode rodar sob demanda ou em agenda recorrente

5. Regras Permanentes

deixar explícita a janela temporal de cada métrica
não misturar métricas incompatíveis sem normalização
registrar falhas parciais de coleta em vez de esconder lacunas
separar dado bruto de interpretação

6. Relação com Workflow

O workflow interno mostra as integrações reais do ASPIRA com Instagram, Meta Ads e YouTube. A Skill Spec mantém o contrato genérico para qualquer stack analítica.

Leitura correta
Skill Spec = portável, genérica, instalável
Workflow = específico, operacional, real