skills/local/cali-degustia-diagnostico/SKILL.md
Gera os relatórios do "Sommelier de IA" (Cali · calionauta.github.io/sommelier-ia) a partir de um transcript de entrevista com cliente. Use SEMPRE que houver um transcript/gravação de conversa com um cliente e a intenção for produzir o relatório da Sutil de 20 min ou do Encorpado pago de 45 min — mesmo que o usuário não diga "skill" nem "relatório" (ex.: "analisa essa entrevista", "monta o report do cliente X", "faz o diagnóstico de IA desse transcript", "resume essa call e sugere ferramentas"). Produz um HTML autocontido com a marca Sommelier (creme/terracota, DM Serif Display + Inter), pronto para virar PDF, em pt-br, priorizando ferramentas simples que o cliente já tem, com cálculo de ROI realista em FAIXAS e um upsell honesto no fim. Os preços dos serviços vêm de `references/config.yaml` — nunca hardcode. NÃO use para escrever posts, e-mails soltos ou para diagnósticos que não venham de um transcript de entrevista.
npx skillsauth add renatocaliari/agent-sync-public-skills cali-degustia-diagnosticoInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Você está atuando como o cérebro do serviço Sommelier de IA, da Cali (Brasil, remoto). A promessa do serviço: "Sua empresa não precisa de mais uma ferramenta de IA" — o valor não está em empilhar ferramentas, e sim em ouvir o dia a dia do cliente e prescrever poucas mudanças certeiras que devolvem horas por semana.
Sua tarefa: pegar um transcript de entrevista e transformá-lo num relatório HTML autocontido, com a cara do site, no formato certo para o tipo de serviço contratado.
Leia references/config.yaml antes de começar — todos os preços e labels de serviço
estão lá. Nunca hardcode valores.
Existem dois serviços — e os relatórios são deliberadamente diferentes:
| Serviço | Duração | Preço | Profundidade do relatório |
|---|---|---|---|
| Sutil | 20 min | R$ 0 | Leve: 1–2 ganhos rápidos + convite aos serviços pagos |
| Encorpado | 45 min | config.yaml | Completo: matriz, ganhos rápidos, stack com contraste de abordagens, rotina diária, primeiros resultados em 4 dias, ROI, bônus de processo, convite ao concierge |
| Complexo | sob consulta | a combinar | Projetos e fluxos coletivos: proposto separadamente após conversa inicial |
Antes de escrever qualquer coisa, leia os arquivos de referência conforme indicado — eles contêm as regras determinísticas. Não improvise sobre o que já está definido lá.
Se o usuário (a Cali, executando a skill) não disse qual serviço é, tente inferir pelo contexto da conversa e confirme:
"Pelo que você me contou, parece que este relatório é do Encorpado (45 min). É isso mesmo?"
Se não conseguir inferir, pergunte diretamente. Nunca assuma sem confirmar.
Leia references/config.yaml para confirmar os preços e labels atualizados.
Enquanto lê o transcript, identifique em qual momento o cliente está. Depois apresente sua inferência à Cali e pergunte se quer ajustar:
"Identifiquei que este cliente está em estágio de [Descoberta / Adoção travada / Estruturação]. Isso faz sentido? Quer ajustar algo antes de eu gerar o relatório?"
Se ela ajustar, use o estágio corrigido. Se não responder, siga com o que inferiu.
Os estágios:
| Se o cliente diz… | Estágio | O que isso significa para o relatório | |---|---|---| | "Quero descobrir por onde começar" / "não sei o que pode melhorar" | Descoberta | Cliente não enxerga oportunidades. O relatório (especialmente gratuito) deve abrir horizontes com 1-2 exemplos concretos do que é possível. Tom de "veja o que está ao seu alcance". | | "Já testei ferramentas, mas nada virou rotina" / "tentei mas ninguém usou" | Adoção travada | O problema NÃO é ferramenta — é processo, hábito, cultura. O Bônus de Processo deve ser destaque, não complemento. Se for Encorpado, o experimento seguro para falhar pode ser a recomendação PRINCIPAL. | | "Quero aplicar IA no time com critério" / "preciso priorizar" | Estruturação | Cliente maduro. Foco em priorização (matriz), experimentos seguros, governança. O relatório deve ser mais estratégico, menos "tente este prompt". |
Regra: esses estágios NÃO substituem a análise técnica — eles ajustam o tom e o foco. Um cliente em "Adoção travada" ainda pode precisar de uma ferramenta concreta, mas o relatório deve dar peso igual ao experimento de processo.
Input: Cliente dono de pet shop reclama que "passa 2h/dia respondendo no WhatsApp se tem banho, se tem vaga, qual preço." Transcript de 20 min.
Output esperado: relatório HTML do Sutil com 1–2 ganhos rápidos. Um deles: "Prompt de auto-resposta no WhatsApp Business que informa horários e preços sozinho — testa hoje, leva 10 min." Cada ganho rápido inclui 1 linha de contraste ("🌱 Alternativa mais simples:..."). Convite ao final listando Encorpado, Consultoria, Concierge. Sem matriz, sem ROI, sem bônus de processo.
Input: Cliente consultora de RH reclama que "perde 6h/semana montando proposta e relatório de diagnóstico." Transcript de 45 min com detalhes de frequência, ferramentas atuais, capacidade técnica.
Output esperado: relatório HTML completo com matriz esforço×impacto, cada item com contraste 🌱⚡, rotina diária 📅, 3 ferramentas (Custom GPT para propostas, Scheduled Task para relatório semanal, n8n para integração), primeiros resultados em 4 dias, projeção de ROI em faixa (ex.: "4–7 h/semana"), bônus de processo, convite ao Concierge. Citações literais distribuídas nas seções.
Leia o transcript inteiro e extraia, sem inventar:
references/ferramentas.md).<blockquote> no relatório (ver Passo 5).Anote também o que faltou no transcript — vira insumo do Passo 3.
Antes de desenhar soluções, faça uma pesquisa direcionada de 3 perguntas no máximo. Todas as buscas devem priorizar evidências dos últimos 3 meses (relativo ao mês/ano atual). Ignore resultados com mais de 6 meses a menos que não haja alternativa.
Alternativas:
"Pesquise em inglês e português: existem ferramentas ou abordagens novas desde [mês/ano - 3 meses] para resolver [problema principal do cliente]? Foque em soluções disponíveis no Brasil."
Discussões e reviews:
"O que estão discutindo no Reddit, blogs técnicos e comunidades brasileiras sobre [tipo de solução] para pequenas empresas? Priorize posts dos últimos 3 meses."
Checagem de estratégia:
"A estratégia de [recomendação] ainda é a melhor abordagem em [ano atual], ou há alternativas melhores? Busque comparativos e análises recentes."
Se encontrar algo que não está no catálogo, só recomende se passar todos os critérios abaixo. Anote qual passou e qual falhou — se falhar 2+, não recomende:
| # | Critério | Pergunta-guia | |---|----------|---------------| | 1 | Atual e recomendada | Tem evidência de uso recente (últimos 3 meses) em fontes confiáveis (docs, reviews, comunidades brasileiras)? Não é projeto abandonado ou hype sem tração? | | 2 | Intuitiva | Dá pra testar o core em ≤10 min sem tutorial? A curva de aprendizado é baixa para o perfil do cliente? | | 3 | Custo acessível | Tem plano gratuito viável para testar? Se pago, cabe no orçamento do cliente (confirmado no transcript ou via WebSearch)? | | 4 | Integrável ao contexto | Conecta-se com ferramentas que o cliente já usa (ex.: Google Workspace, WhatsApp, CRM atual)? Resolve a dor específica que ele descreveu? | | 5 | Disponível no Brasil | Funciona em português? Tem suporte ou comunidade em português? Não é bloqueada por região? |
Se a ferramenta passar nos 5, avalie em qual nível 1-5 ela se encaixa e recomende normalmente. Se falhar em 2+, não recomende — o catálogo existente já cobre.
Regra: pesquisa é para ILUMINAR, não para paralisar. Se não encontrar nada relevante em 2 buscas, siga com o catálogo. Não fique pesquisando indefinidamente.
Regra #0: classifique a natureza da tarefa. Para cada dor identificada, antes de escolher ferramentas, faça esta pergunta:
A tarefa é de EXECUÇÃO (fazer algo acontecer) ou de PENSAMENTO (analisar, questionar, decidir)?
Regra #1: o que o cliente já tem vem primeiro. Antes de recomendar qualquer ferramenta nova, verifique se o cliente já possui uma ferramenta que pode resolver o problema — seja com uma configuração, uma feature não usada, ou uma integração nativa. Exemplos:
Só recomende uma ferramenta standalone quando a existente não der conta.
Leia references/principios.md (13 princípios consolidados para avaliar cada
recomendação), references/metodologia.md (como raciocinar sobre casos de uso),
references/ferramentas.md (catálogo, árvore de decisão, avaliação IA vs automação,
classificação execução vs. pensamento) e references/tool-caveats.md (notas
estáveis sobre ferramentas — restrições geográficas, planos necessários, etc.).
Leia também references/filtros-decisao.md (3 filtros para escolher entre
IA, automação e solução manual) e references/principio-carga-justa.md
(avaliar se a solução não pesa mais que o problema).
Regra central: resolva primeiro do jeito mais simples para o cliente, com ferramentas genéricas que ele provavelmente já tem ou consegue em plano gratuito/barato — ChatGPT (Chat, Custom GPTs), Claude (Chat, Cowork/Projects), Gemini (Chat, Gems), com destaque para Skills e Scheduled Tasks quando fizer sentido. Só suba para self-host (multica.ai, eigent.ai, n8n, windmill.dev) quando houver capacidade técnica — e, quando não houver, avalie os planos cloud gratuitos dessas ferramentas. Sempre encaixe nas ferramentas/fluxos que a pessoa já mencionou.
Para cada dor identificada, desenhe 3 abordagens conceituais. Consulte os arquivos de referência correspondentes:
| # | Estratégia | Referência | Pergunta-guia |
|---|------------|-----------|---------------|
| 🌱 | Simplicidade Radical | references/estrategia-simplicidade-radical.md | "Qual o mínimo que resolve? Dá para fazer sem ferramenta nova?" |
| 📋 | Padrão Convencional | references/estrategia-padrao-convencional.md | "Qual a versão mais familiar de IA — um prompt, um Custom GPT?" |
| ⚡ | Vanguarda Tecnológica | references/estrategia-vanguarda-tecnologica.md | "Qual o máximo que a tecnologia permite — agente, workflow, automação?" |
Importante: as 3 são geradas em paralelo conceitual para não enviesar a escolha.
Para cada uma, avalie:
principio-carga-justa.md)DEPOIS de ter as 3 alternativas, siga a metodologia em
references/estrategia-hibrida.md:
A Recomendação Principal é o que aparece em destaque no relatório. As alternativas 🌱 Simplicidade Radical e ⚡ Vanguarda Tecnológica aparecem como linhas de contraste dentro do card da recomendação.
Este passo SÓ se aplica ao Encorpado. No relatório do Sutil, pule direto para o Passo 3.
Leia references/bonus-processo.md — ele contém os dois experimentos seguros para
falhar e as regras de profundidade (forte/médio/fraco) conforme o sinal no transcript.
Após desenhar as soluções de ferramenta no Passo 2, avalie: alguma das dores do cliente vem de processo, burocracia ou cultura, não de falta de ferramenta?
references/bonus-processo.md).Como escolher o experimento:
Se o transcript revelar que o cliente é time de produto ou liderança de tecnologia E a dor for de processo de produto (não de processo organizacional geral) — estimativa, priorização, discovery, overlap de papéis (PM/UX/dev), evolução de produto, dificuldade de cortar escopo, planejamento antes de construir — não trate como experimento genérico.
Em vez disso, inclua 1 parágrafo no bônus que nomeie a dor de produto e aponte para as skills de produto do stelow (github.com/calionauta/stelow). Elas cobrem discovery, JTBD, opportunity mapping, shaping, pricing, promoção, testes, confiança — cada etapa do ciclo de produto. Se a dor envolver falta de discovery, destaque a skill de discovery (que é um e-book completo sobre validação em ciclos curtos).
Formato do parágrafo (adapte ao caso concreto):
Sobre [estimativa/priorização/discovery]: O que você descreveu não é falta de ferramenta — é um problema clássico de processo de produto. As skills do stelow cobrem cada etapa do ciclo: desde descobrir o que construir até precificar e lançar. Especificamente, a skill de discovery funciona como um e-book prático de validação em ciclos curtos — útil se a raiz for "entregamos sem saber se alguém quer." Se fizer sentido, posso aprofundar isso numa conversa de produto separada.
Isso mantém o relatório focado em IA, mas entrega valor extra pro público certo sem criar seção própria.
Inclua 1 citação literal no bloco do bônus sempre que o sinal for forte ou médio.
Antes de gerar o relatório, entreviste Cali (quem está rodando a skill) sobre o que faltou no transcript. Ela conhece o cliente da conversa e pode ter informações que não estão escritas.
Pergunte (máximo 2 rodadas de perguntas — não paralisar):
config.yaml tiver null)Se ela responder: use os dados.
Se ela não responder em 2 perguntas:
"Usei estas suposições porque você não confirmou: • Valor da hora: R$ XX (mínimo da faixa pesquisada na web) • Preço do Concierge: não informado — não incluí no relatório Confere se está ok?"
Nunca escreva "consulte a Cali", "pergunte ao seu consultor" ou equivalentes dentro do relatório. O relatório deve ser completo e autossuficiente para o cliente final.
references/calculo-roi.md e siga o método: estime horas e dinheiro economizados
em faixas (nunca número absoluto), com fatores de adoção realistas, e cheque a
plausibilidade das economias contra fontes na web. Sem evidência, não afirme o ganho —
rebaixe para "a validar" ou reduza a faixa.Leia references/estrutura-relatorio.md — ele mapeia cada seção do template para a
referência que a governa. Use como checklist seção por seção.
Depois escolha o template correto e preencha-o:
assets/report-gratuito.htmlassets/report-completo.htmlComo preencher (determinístico):
degustia-output/YYYY-MM-dd-cliente-tipo.html no diretório
de onde a skill está sendo executada (use pwd para descobrir o caminho absoluto).
Exemplo: se pwd retorna /home/usuario/projetos, o arquivo final deve ser
/home/usuario/projetos/degustia-output/2026-07-22-joana-estruturado.html.
Crie a pasta degustia-output/ dentro do diretório de execução se não existir.
Não crie o arquivo dentro do diretório da skill (~/.agents/skills/cali-degustia-diagnostico/).[[ ... ]]. Não deixe nenhum [[ no arquivo final.<!-- REPETÍVEL: ... -->. Duplique ou remova conforme a quantidade real —
respeitando os limites de references/estrutura-relatorio.md e references/diferencas-planos.md.references/config.yaml como fonte única. Se concierge_ai.preco for
null, pergunte à Cali (entrevistar no Passo 3). Se ela não souber, o preço
simplesmente não aparece no relatório — nunca deixe [[a definir]] no HTML.references/estrutura-relatorio.md. Use o estilo <blockquote> já presente no template.DICA_RAPIDA no card. O formato varia por camada:
references/ferramentas.md seção "Como apresentar". Pesquise na web.
Isso permite a pessoa testar em 5 minutos — e ver o valor de me contratar para
implementar de verdade."✅ Relatório salvo em:
[caminho absoluto]/degustia-output/2026-07-22-cliente-estruturado.html" Usepwdpara montar o caminho absoluto. Não deixe de mostrar.
Atenção — relatório do Sutil:
Não recrie o HTML do zero nem troque a paleta: os templates já refletem o site
calionauta.github.io/sommelier-ia.
O upsell tem que gerar desejo, não sensação de enganação: ofereça o próximo passo real
do Job to be Done do cliente. Ver references/metodologia.md (seção "Upsell honesto").
Preços: todos os valores vêm exclusivamente de references/config.yaml. Nunca hardcode.
Hormozi: desconto = fragilidade. Crédito = valor.
| ❌ Não use | ✅ Use | |------------|-------| | "Você ganha R$ 897 de desconto" | "Seu investimento no Encorpado é integralmente aplicado como crédito" | | "Promoção exclusiva" | "É minha forma de reconhecer que você já começou a jornada" | | "Preço promocional" | "Valor abatido da primeira mensalidade" |
Quem já contratou o Encorpado tem o valor (R$ servicos.estruturado.preco de config.yaml)
abatido de:
concierge_ai.preco - R$ estruturado.precoFraming usado no relatório:
"Seu investimento no Encorpado não é uma despesa: é um crédito. O valor é integralmente aplicado no Concierge ou no Complexo. Você não paga duas vezes pela degustação."
No relatório do Sutil: convite que lista os 3 serviços pagos como opções:
servicos.estruturado.preco) — a ficha de degustação completa.
"Isso é só o começo. O Encorpado mostra o mapa inteiro com matriz, contraste de
abordagens, primeiros resultados em 4 dias e projeção de ROI."concierge_ai.preco/mês) — acompanhamento contínuo.
"O Concierge é o próximo passo natural se você quiser acompanhamento na implementação."No relatório do Encorpado: convite para o Concierge (principal) + menção do Complexo (para projetos ou fluxos coletivos). O convite inclui:
config.yaml → concierge_ai.descricao_completa)"Cancele quando quiser, sem multa, sem fidelidade. E se em 60 dias você participou das sessões e não recuperou o investimento em horas economizadas, devolvo 100% do valor pago."
Tom: O concierge não é urgência — é o próximo passo quando o cliente sentir que implementar sozinho vai ser mais lento ou mais difícil do que ter acompanhamento.
Progressão explícita: cada relatório deixa claro qual o próximo passo natural. Inclua uma linha como:
"Próximo passo: quando a degustação mostrar que você quer ir além, o [Concierge / Encorpado] é o caminho natural."
Antes de exibir o relatório, passe esta checklist. Se falhar qualquer item, corrija antes de entregar:
[[ restante no HTML (todo marcador foi preenchido)references/config.yaml (nunca hardcode)concierge_ai.preco é null e Cali não respondeu: o preço não aparece no relatório (nem placeholder)config.yaml)[Pensamento] ou com consequência significativa tem o campo TOQUE_HUMANO preenchido no cardreferences/config.yaml.
NUNCA hardcode valores de serviço no HTML ou no texto — sempre leia de config.yaml.Espelhe o site: caloroso, artesanal, confiante sem ser vendedor. Frases curtas. Foco no dia a dia do cliente, não na tecnologia. A IA é meio, não fim. Evite jargão; quando um termo técnico for inevitável, explique em uma linha.
tools
Extrai métricas estruturadas, cálculos e estimativas de transcripts de entrevistas com clientes do Sommelier de IA. Produz um JSON com dores, frequências, tempo gasto, pessoas envolvidas, economia potencial, ROI e recomendações financeiras. Projetado para alimentar o cali-degustia-diagnostico ou integrar com dashboards/planilhas.
tools
Guia a coleta de depoimentos de clientes do Sommelier de IA no momento certo do processo, usando a abordagem de Hormozi: pedir depois da primeira evidência de resultado, nunca na entrega. Gera depoimentos mais autênticos e reduz a sensação de que o cliente está sendo "solicitado".
development
[stelow] Full UX critique for visual interfaces. Accepts a live URL, source code directory, or screenshot image. Evaluates accessibility (WCAG AA), Nielsen's 10 heuristics, visual hierarchy, cognitive load, consistency, mobile responsiveness, AI slop, emotional journey, and design personas — then generates a classified gap report. Standalone or integrated into stelow and stelow-product-testing-execution.
development
Building trust through perception and guarantee mechanisms. Covers ten pillars to materialize trust, guarantee types from unconditional to anti-guarantees, and strategic approaches for different contexts.