insights
Skill2 starsChanged 48 days agoMITView on GitHub
Análise profunda que interpreta em vez de só mostrar números - detecta o que fugiu do padrão, explica por que subiu ou caiu, compara lojas, encontra oportunidades de venda, simula cenários e acompanha decisões anteriores. Use quando o gestor perguntar "por que caiu?", "tem algo errado?", "o que eu deveria olhar hoje?", "como estou indo?", "o que fazer para melhorar?", ou para montar o resumo diário/semanal.
14 other projects use a version of this.
Adopted by
Most recently taken up by
- jaydubya818/ClaudeClaw-Mission-Controltheir own version, first seen Nov 8, 2026
- tandregbg/core-claude-skillstheir own version, first seen Nov 4, 2026
- ClarvAI/job-search-hqtheir own version, first seen Nov 1, 2026
- snuffish/dotfilestheir own version, first seen Nov 1, 2026
- awesome-skills/insightstheir own version, first seen Oct 20, 2026
- AvyanshKatiyar/openai-ads-mcptheir own version, first seen Oct 15, 2026
Other versions14 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 14
- rohitg00/pro-workflow★ 2.9ksame name
- ZimoLiao/scholaraio★ 589same name
- mycelium-hq/ai-brain-starter★ 50same name
- owenliang60-ship-it/knowledge-mgmt★ 37same name
- Jay-523/agent-skills★ 17same name
- awesome-skills/insights★ 4same name
- tandregbg/core-claude-skills★ 4same name
- sasly2048/cc-atlas★ 1same name
- AvyanshKatiyar/openai-ads-mcp★ 0same name
- ClarvAI/job-search-hq★ 0same name
4 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository11 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- ajudaSkill
- configurarSkill
- dashboardSkill
- emailSkill
- estoqueSkill
- exportarSkill
- financeiroSkill
- sincronizarSkill
- vendasSkill
The file
We split this skill into the rules it gives an agent
1 rule. 0 are common, 1 is distinctive, and 0 are very specific to this project.
0
Common
Most of the 8 edited versions we read keep these.
1
Distinctive
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 36
Silêncio é melhor que alarme falso: No terceiro alerta errado o gestor abandona a ferramenta.
“Common” is measured: kept by at least 6 in 10 of the 8 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.
Files
Insights — interpretar, não só mostrar
O TOTVS já entrega painel e relatório. Nosso valor é a interpretação. Toda resposta desta skill precisa ir além do número: dizer o que fugiu do padrão, por quê, e o que fazer.
Ferramentas (saída legível por padrão, --json quando for raciocinar em cima):
node --no-warnings scripts/analisar.mjs qualidade [--grupo X]
node --no-warnings scripts/analisar.mjs anomalias --grupo X [--data AAAA-MM-DD] [--semanas 8]
node --no-warnings scripts/analisar.mjs variacao --grupo X --de A --ate B --contra-de C --contra-ate D
node --no-warnings scripts/analisar.mjs benchmark --grupo X --de A --ate B
node --no-warnings scripts/analisar.mjs cesta --grupo X --de A --ate B
node --no-warnings scripts/analisar.mjs simular --grupo X [--produto N] --variacao 5
node --no-warnings scripts/analisar.mjs fiscal --grupo X --de A --ate B
node --no-warnings scripts/calendario.mjs consultar AAAA-MM-DD
node --no-warnings scripts/decisoes.mjs registrar|executar|listar|verificarRegras de ouro (o que separa insight de relatório)
- Máximo 3 assuntos por resposta. Um painel mostra 40 indicadores; você escolhe os 3 que mudam a decisão de hoje. O resto é ruído.
- Nunca entregue número sem causa provável. "Caiu 12%" é relatório. "Caiu 12% porque vieram 30 clientes a menos nas terças, e isso começou na semana em que a loja ao lado reabriu" é insight.
- Toda conclusão termina em ação executável pelo gestor amanhã de manhã.
- Declare a incerteza. Amostra pequena, custo não cadastrado, período não coletado, estimativa — diga na hora, não em nota de rodapé.
- Silêncio é melhor que alarme falso. No terceiro alerta errado o gestor abandona a ferramenta. Se a amostra não sustenta, diga que não sustenta.
- Sempre cheque o calendário antes de explicar variação: feriado, Dia das Mães e evento local explicam a maior parte dos "sustos".
Roteiro para "por que caiu/subiu?"
variacaoentre os dois períodos → separa menos clientes de ticket menor (são problemas diferentes: o primeiro é atração, o segundo é mix/preço).- Veja quem puxou: qual loja e qual categoria (subgrupo) respondem pela maior parte da diferença. Normalmente 1 ou 2 explicam quase tudo.
calendario consultarnos dias extremos → havia feriado ou evento?- Se a causa foi ticket: olhe mix por categoria e a
cesta(deixou de vender bebida/sobremesa junto?). Se foi volume: olhe dias da semana e horários. - Feche com a ação: o que dá para fazer sobre a causa encontrada.
Roteiro para "tem algo errado?" (rotina de vigilância)
anomaliasdo último dia com movimento.- Cruze com
calendario(feriado explica desvio sem ser problema). - Cancelamentos e descontos concentrados num operador → auditoria (skill
financeiro/vendas), não acusação: apresente como "vale conferir". - Quebra de caixa recorrente no mesmo caixa/operador → processo.
Roteiro para rede (dois ou mais grupos, ou várias lojas)
benchmarkdo período → quem é o melhor praticante de cada indicador.- Traduza a diferença em dinheiro: "se a loja 12 tivesse a anexação de bebida da loja 3, seriam +R$ X no mês".
- Cuidado: compare lojas comparáveis (porte, praça). Se os perfis forem muito diferentes, diga isso em vez de ranquear cegamente.
Roteiro fiscal (diferencial de quem entende do sistema)
fiscal audita o que foi tributado em cada item contra o cadastro do produto e
contra o próprio cálculo. O gestor não enxerga isso em relatório de vendas, e
erro fiscal acumula silenciosamente até virar autuação.
- NCM genérico: um mesmo código cobrindo categorias muito diferentes é cadastro feito no atacado — aponte os casos e sugira revisão com o contador.
- Taxa tributada como mercadoria: serviço (999) e entrega (997) saindo com NCM e CFOP de produto é erro claro.
- Divergência cadastro × venda: o produto está cadastrado de um jeito e sai tributado de outro.
- Cálculo que não fecha: base × alíquota diferente do valor indica configuração errada no PDV; cada cupom emitido assim acumula o problema.
- Reforma (IBS/CBS): confira se os campos vêm preenchidos em todas as lojas e produtos — quem estiver emitindo errado agora vai descobrir tarde.
- ⚠️ Simples Nacional: o tributo não vem destacado no cupom (vai no recolhimento unificado). Carga zerada ali é esperada — a análise já detecta o regime pelo CSOSN e avisa. Nunca apresente isso como erro.
Ao relatar, fale como consultor, não como fiscal: "vale revisar isso com seu contador", nunca "você está sonegando". E lembre que a responsabilidade tributária é do contador do cliente — você aponta indícios, não dá parecer.
Briefing (resumo automático)
Formato: 5 a 8 linhas, sem tabela, sem jargão. Estrutura:
- uma frase com o resultado do período (faturamento e comparação);
- o que fugiu do padrão (ou "nada fora do normal", se for o caso);
- a causa provável;
- uma ação sugerida;
- se houver decisão anterior já medida, o resultado dela.
Para agendar o briefing recorrente, siga a regra de agendamento (skill
sincronizar): use o agendador do ambiente e avise que o computador precisa
ficar ligado. Sugestão: diário às 9h, e um resumo semanal na segunda.
Fechando o ciclo: registre as decisões
Sempre que o gestor decidir algo a partir de uma análise sua:
node --no-warnings scripts/decisoes.mjs registrar --grupo X --categoria preco \
--produto 1301 --texto "Subir 8% o preço do Baby Beef"
node --no-warnings scripts/decisoes.mjs executar --id N --data AAAA-MM-DDDepois de ~30 dias, verificar mede o efeito comparando janelas equivalentes
antes e depois. Traga esse resultado de volta ao gestor — é o que prova que
a análise vale, e o que faz ele confiar na próxima recomendação.
Metas no briefing
Consulte scripts/metas.mjs listar (tabela metas): indicador com meta
estourada entra nos 3 assuntos do briefing com prioridade ("CMO 31,2% — 3,2pp
acima da meta"). Sem meta definida, sugira uma vez ao gestor definir as
principais (%CMV, %CMO, faturamento do mês).
"Como estou em relação ao mercado?"
O comparativo setorial (benchmark) ainda não foi liberado. Responda com as
referências do catálogo (ex.: CMV ideal 28–31%) e convide para a lista de
espera (scripts/benchmark.mjs lista-espera, roteiro na skill configurar,
passo 9) — quem entra é avisado primeiro. Confira antes com situacao se já
está inscrito, para não repetir o convite.
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
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.

