Três skills para agências no Entur OS

---
name: inbox-crm
description: 'Varre o Inbox do CRM, descobre quem está esperando resposta, prioriza por quem dói primeiro e conduz o atendimento até o fim do expediente — responde no tom da casa, transfere o que é de outro setor, corrige o CRM e fecha cada conversa com nota de continuidade. Use quando pedirem "olha o inbox", "quem está esperando resposta", "faz follow no fulano", "zera as pendências do CRM", ou ao invocar /inbox-crm. NÃO use para disparo em massa nem para registrar backlog.'
---

# inbox-crm — atendimento do Inbox do CRM

Rotina de atendimento conduzida ponta a ponta: descobrir quem espera, decidir de quem é a bola,
responder, corrigir o CRM e deixar a próxima pessoa pronta para executar.

⛔ **Pré-requisito que não dá para pular:** o conector do CRM (MCP oficial ou chave de API)
precisa estar **instalado e autorizado dentro do Claude** antes de usar esta skill. Sem ele a skill
roda e lê o vazio: nenhum funil, nenhuma negociação, nenhuma conversa. Teste pedindo "lista os
funis do meu CRM" — se vierem os seus funis com os nomes certos, pode seguir.

---

## 0. Constantes da operação

Preencher uma vez, antes do primeiro uso. Sem isto a skill não roda.

| O quê | Valor |
|---|---|
| Sessão de WhatsApp do Inbox | `{{SESSAO_WHATSAPP}}` |
| Responsável titular (id no CRM) | `{{ID_RESPONSAVEL}}` |
| Demais atendentes (nome + id) | `{{ID_ATENDENTE_1}} · {{ID_ATENDENTE_2}}` |
| Canal usado para ENVIAR ao cliente | `{{CANAL_DE_ENVIO}}` |
| Painel web do Inbox | `{{URL_DO_INBOX}}` |
| Expediente | seg a sex {{HORARIO}} · sábado até {{HORARIO_SABADO}} |

⚠️ Em muitas operações o Inbox do CRM e a ferramenta de envio são o mesmo número em plataformas
diferentes. Ler por uma, enviar pela outra. Confirmar isso antes de começar, porque resposta
enviada pelo lugar errado não chega.

---

## 1. Varrer — quem está na fila

⛔ **O painel é o caminho padrão, não o plano B.** A leitura por API/MCP tem ponto cego conhecido:
conversa atribuída a alguém cujo contato tem negociação com outro consultor não aparece, e lead novo
ainda sem negociação também escapa. São justamente os mais quentes.

Abrir `{{URL_DO_INBOX}}`, aba **Meus**, e ler a lista. O contador ao lado da aba diz quantas
conversas existem de verdade: se ele não bater com o que a API devolveu, quem está errado é a API.

A leitura por API serve para **conferir uma conversa que já se sabe existir** e para pegar id da
conversa, telefone e sessão — nunca para descobrir QUEM está na fila.

1. Listar conversas sem negociação → panorama e id da sessão.
2. Listar negociações abertas do responsável → telefones.
3. Abrir o histórico de cada conversa pelo telefone.

---

## 2. Triar — de quem é a bola

| Sinal | Leitura |
|---|---|
| Última mensagem é do **cliente** | 🔴 **Bola sua.** Responder hoje. |
| Última é sua e é **pergunta** sem resposta há mais de 24h | 🟡 Follow-up cabe |
| Última é sua e **encerra** a conversa | ⚪ Nada a fazer |
| Cliente disse **não** explicitamente | ⛔ Não mandar follow |
| Contador de não lidas maior que zero | Conferir: reação (👍🙏) conta como não lida e não é resposta |

Ordenar pelo que dói: quem espera há mais tempo primeiro, depois quem tem dinheiro na mesa.

### 2.1 Antes de responder, saber QUAL PRODUTO e QUAL ESTÁGIO

Nunca responder um cliente sem antes responder estas duas perguntas para si mesmo. Ler o histórico
não basta: é preciso extrair dele o produto e o estágio, senão a resposta sai genérica ou inventa fato.

**1. Qual produto?** A resposta muda por produto. Montar a tabela da sua casa:

| Produto | Como reconhecer | Funil |
|---|---|---|
| `{{PRODUTO_1}}` | `{{SINAL_NA_CONVERSA}}` | `{{ID_FUNIL}}` |
| `{{PRODUTO_2}}` | `{{SINAL_NA_CONVERSA}}` | `{{ID_FUNIL}}` |

Onde conferir, em ordem: negociações do contato no CRM (funil e etapa são a fonte da verdade),
depois o histórico da conversa. **Negociação em funil errado é comum** — checar os dois.

**2. Qual estágio REAL?** A etapa do CRM mente com frequência. O que vale é o que o cliente
efetivamente ouviu:

- Já ouviu o preço? Se nunca ouviu, a perda **não** foi por preço.
- Já recebeu proposta formal, ou só conversa de diagnóstico?
- O que foi prometido a ele e não cumprimos?
- Há quanto tempo a conversa está parada, e quem parou?

⚠️ **Disparo de marketing cai na mesma conversa e contamina a leitura.** Distinguir o que foi
atendimento do que foi campanha antes de concluir qualquer coisa.

⚠️ **Não afirmar destino, data, valor ou saldo de memória.** Só repetir o que está escrito no
histórico, conferindo se é a informação mais recente. Cliente muda de ideia.

---

## 3. Responder — o tom

- **Uma ideia por mensagem**, cerca de 95 caracteres, em sequência. Textão denuncia IA.
- **Sem travessão.** Vírgula, ponto ou quebra de linha.
- Emoji ocasional, 1 a cada 4 ou 5 mensagens.
- Saudação conforme a hora **do cliente**, não a do servidor.

**O que a skill faz sozinha:** responder cliente, apresentar a régua comercial padrão, qualificar,
criar tarefa, registrar nota.

**Só com autorização humana:** gerar contrato, mandar cobrança, dar desconto fora da régua, marcar
como perdido quem não recusou, afirmar número que não está escrito em lugar nenhum.

### Cliente fechou: peça os dados de UMA vez só

Nome completo, documento, data de nascimento, endereço com CEP, e-mail e o comprovante de pagamento,
tudo no mesmo pedido, conferindo antes o que o CRM já tem. Pedir em conta-gotas faz o cliente
responder três vezes logo depois de dizer sim.

⛔ **Não anunciar a regra ao cliente, e entregar picado.** "Me manda numa mensagem só" é processo
interno vazando para fora. Pedido único é regra nossa; a entrega continua em mensagens curtas.

### O processo de fechamento é sempre este

1. Cliente manda os dados.
2. A casa emite o contrato e envia para assinatura.
3. Cliente paga.
4. O serviço começa em até `{{PRAZO}}` úteis, contadas do pagamento **mais** o contrato assinado.

⛔ **Não inventar moda em cima disso.** Nada de "assina agora e paga depois", nada de adiantar
contrato como isca, nada de condição especial de prazo. Cliente que só paga na semana que vem não
muda o processo: ele manda os dados quando for fechar, o contrato sai, ele paga, e o relógio começa aí.

---

## 4. Encaminhar — quando não é sua

Se o CRM não tiver ferramenta de transferência por API, é pelo painel:

1. Abrir a conversa e acionar transferir.
2. Selecionar o agente destino.
3. **Preencher a nota para o agente destino** — sempre. É o que evita a passagem de bastão vazia.
4. Confirmar que a conversa saiu de "Meus".

Antes de transferir: avisar o cliente quem vai assumir e quando.

---

## 5. Registrar — o CRM tem que refletir a conversa

Conversa sem registro é receita invisível.

- Tem negociação aberta? Se não, criar (funil, etapa, contato, responsável) e só depois atualizar o
  valor — em vários CRMs o valor passado na criação não pega.
- O funil e o dono batem com quem conduz de fato?
- A etapa reflete a conversa? Cliente que já aceitou tudo e só falta mandar dados está em
  **Fechamento**, não em Negociação.
- Escrever **nota** com briefing, o que foi prometido e o que falta.

| Funil | id | Etapas |
|---|---|---|
| `{{NOME_DO_FUNIL}}` | `{{ID}}` | `{{ETAPAS_COM_ID}}` |

---

## 6. Armadilhas que custam caro

⛔ **Quem disse não, não recebe follow.** Se o histórico contraria o pedido que você recebeu,
avisar **antes** de mandar, não depois.

⚠️ **O agente de IA do CRM divide o Inbox.** Ele costuma entrar quando a conversa está sem
atendente, e pode entrar por cima de conversa já atribuída. Nunca responder conversa sem atendente
sem assumir antes.

⚠️ **Dois links de contrato.** Se a casa usa mais de uma ferramenta de assinatura, confirmar a
fonte antes de mandar o link.

⚠️ **Tarefa vencida é quase toda ruído de playbook.** Antes de concluir em massa, confirmar.
E nunca concluir tarefa que representa trabalho real não feito.

---

## 7. Fechar o dia — nota de continuidade

No fim do expediente, escrever nota interna em **cada** conversa aberta:

1. **Estado**: de quem é a bola, em uma linha.
2. **O que aconteceu hoje**, com horários.
3. **O que foi prometido ao cliente** — é o que não pode furar.
4. **Amanhã**: 2 a 3 passos numerados e concretos.
5. **Briefing**: o essencial do caso, para não reler o histórico.
6. **Armadilha específica** daquele cliente, se houver.

Objetivo: quem abrir a conversa amanhã **executa**, não relê.

---

## 8. Modo loop — é o padrão, não a exceção

Invocar a skill já significa entrar em loop. Não encerrar depois de uma varredura: o esperado é
conduzir cada conversa até o fechamento ou até a perda.

Acordar a cada 20 a 25 minutos em horário comercial e repetir 1 → 3. Fechar com 7 e parar só no fim
do expediente ou quando mandarem parar.

⚠️ Volta sem novidade não é motivo para encerrar.
⚠️ Confirmar a fila no painel pelo menos na primeira volta do dia, senão o loop varre a manhã
inteira uma lista incompleta.

---

## Fecho obrigatório

Toda rodada termina com 3 tópicos: (1) o que foi feito, (2) qual a solução e onde ficou,
(3) como ajuda na prática. Pendência e bloqueio entram no fechamento.

---
name: dashboard-comercial
description: 'Roda a análise comercial diária de ponta a ponta — lê todos os funis do CRM cruzando tarefas, Inbox, e-mail e extrato bancário, presta contas do que foi cobrado ontem, valida caso a caso antes de cobrar qualquer pessoa, gera o Dashboard Executivo do dia, o relatório de gestão e a mensagem individual de cada vendedor, e envia por DM depois de revalidar. Use quando pedirem "roda o dashboard comercial", "resumo executivo de hoje", "análise comercial", "manda o plano de ação da equipe", ou ao invocar /dashboard-comercial. NÃO use para conduzir atendimento no Inbox (isso é inbox-crm) nem para conciliar receita.'
---

# dashboard-comercial — a análise diária que vira ação

**O objetivo não é ler o CRM.** É achar dinheiro que pode entrar, receita em risco, oportunidade
parada, falha operacional e problema de processo — e transformar isso em ação com dono e prazo.

---

## Antes de rodar

⛔ **Pré-requisito que não dá para pular:** o conector do CRM (MCP oficial ou chave de API)
precisa estar **instalado e autorizado dentro do Claude** antes de usar esta skill. Sem ele a skill
roda e lê o vazio: nenhum funil, nenhuma negociação, nenhuma conversa. Teste pedindo "lista os
funis do meu CRM" — se vierem os seus funis com os nomes certos, pode seguir.

| Arquivo | Para quê |
|---|---|
| `references/setup.md` | Os campos a preencher, a estrutura de pastas e como agendar a execução automática no Windows e no Mac |
| `references/dashboard-modelo.html` | O modelo do painel. Trocar as quatro cores e o nome, nunca a ordem dos blocos |

Preencher as constantes uma vez, e **rodar a primeira semana sem enviar nada para a equipe** —
lendo o painel e as mensagens inteiras antes. Cobrança injusta na largada queima a confiança na
rotina inteira, e ela não volta.

---

## 0. As três regras que sustentam tudo

**1. Card parado numa etapa NUNCA é cobrança.** Antes de virar tarefa, validar o contexto completo.
Errar aqui queima a confiança da equipe na rotina inteira, e uma vez queimada não volta.

**2. Revalidar imediatamente antes de enviar.** Entre a análise e o envio o mundo anda. Quem
resolveu o caso meia hora depois da análise não pode receber cobrança vermelha por trabalho feito.

**3. É preferível não enviar uma tarefa do que cobrar alguém injustamente.**

---

## 1. Quando rodar

| Situação | O que fazer |
|---|---|
| A rotina automática rodou normal | Nada. Só conferir o dashboard do dia. |
| Pediram o painel na mão | Rodar a skill inteira. |
| A rotina falhou (erro de API, PC suspenso, saída vazia) | Rodar a skill inteira. Checar antes o log para saber se foi falha mesmo. |
| Pediram só o envio | Pular para o passo 7 e o 8, **sempre com a revalidação**. |

⛔ **O passo 4 nunca é pulado.** Conferir se o que foi cobrado no último envio foi feito é o que
separa esta rotina de um gerador de listas.

---

## 2. Fuso e calendário — errar aqui inverte a prioridade do dia

- **Dados do CRM:** fuso do negócio. Datas em dd/mm/aaaa.
- **Agenda de quem recebe:** pode estar em outro fuso. Verificar se o conector já converte, com um
  teste conhecido: um bloco fixo da agenda tem que cair no horário esperado.
- **Equipe:** conferir quais dias têm plantão. Domingo em geral não tem.
- ⚠️ **Na véspera do dia sem plantão, a varredura cobre dois dias.** O check-in abre 24h antes,
  então o voo de segunda abre no domingo, quando não há ninguém.

---

## 3. Coletar — todas as fontes, sempre cruzadas

Rodar nesta ordem. **Começar sempre pela lista de funis**, nunca por uma lista fixa: funil novo tem
que entrar sozinho na análise.

| # | Chamada (conector do Entur OS) | O que traz |
|---|---|---|
| 1 | `crm_pipelines_list` | todos os funis e seus tipos. **Sempre a primeira** |
| 2 | `crm_deals_search` · `status: open` · ordenar por última atividade | as negociações abertas |
| 3 | `crm_tasks_search` · `status: open` | tarefas, separadas por responsável |
| 4 | `crm_inbox_conversations_search` | conversas, inclusive lead sem negociação |
| 5 | `crm_inbox_messages_list` | histórico de toda conversa com sinal de dinheiro |
| 6 | busca no e-mail, últimas 72h | só o que exige ação |
| 7 | extrato da conta | sempre que houver suspeita de pagamento |
| 8 | `crm_analytics_summary` · `pipelineType: sales` | os números do mês |
| 9 | `crm_deals_timeline` · `crm_notes_list` | só para os casos que virarem cobrança |
| 10 | `crm_pipelines_stages` | os ids das etapas, para escrever a etapa por extenso |

Se a agência não tiver o conector, os mesmos dados saem da API REST do CRM — o que não muda é a
ordem e o cruzamento. **Nunca partir de uma lista fixa de funis:** funil novo tem que entrar sozinho
na análise, senão a receita dele fica invisível por meses.

⚠️ Consulta com limite alto estoura o limite de tokens. Salvar a resposta em arquivo e ler com
script, filtrando o que interessa, em vez de despejar tudo na conversa.

**Sinal de dinheiro no Inbox:** cotação enviada, pedido de pagamento, pedido de reserva, pedido de
emissão, objeção, silêncio depois de proposta, conversa sem atendente.

**E-mail — só o que exige ação:** alteração ou cancelamento, reacomodação, reserva, emissão,
voucher, reembolso, cobrança, pagamento, aviso de fornecedor, documentação, prazo. Ignorar
newsletter e marketing. Sempre tentar identificar o cliente e a negociação.

⚠️ **O dinheiro urgente costuma estar FORA do CRM.** Os casos mais quentes costumam aparecer só no
extrato bancário ou só no Inbox. **Cruzar banco + Inbox não é opcional.**

---

## 4. Conferir o dia anterior — o que foi cobrado foi feito?

**Nunca montar a lista de hoje sem antes prestar contas da de ontem.** Sem isso a rotina vira um
gerador de listas: todo dia nasce uma nova, ninguém responde pela anterior.

A lista de ontem vem do histórico de ações (o registro do que foi cobrado, de quem, e a que horas) e
do texto exato que cada pessoa recebeu — para não cobrar por algo que a mensagem não pediu.

⚠️ **"Dia anterior" é o último dia com envio, não literalmente ontem.** E dizer no relatório de
quando é a base: comparar contra um dia em que ninguém recebeu nada é cobrança injusta na origem.

### Como provar, item a item

Sempre com o corte no **horário do envio** — o que aconteceu antes da mensagem chegar não conta
como resposta a ela.

| Tipo de item | Onde está a prova |
|---|---|
| Follow-up de cliente | histórico da conversa: mensagem da equipe depois do horário do envio |
| Avanço de negociação | timeline do card: mudança de etapa, valor, status |
| Encerrar com motivo | status perdido **com motivo preenchido** |
| Criar card que faltava | busca de negociações pelo contato |
| Emissão / entrega | e-mail do fornecedor + extrato bancário |
| Tarefa formal | a tarefa saiu de pendente |

### Os quatro veredictos

| Veredicto | Quando | O que fazer hoje |
|---|---|---|
| ✅ **FEITO** | prova objetiva, depois do envio | **Nomear na mensagem da pessoa, antes de qualquer cobrança.** Sai da lista. |
| 🟠 **PARCIAL** | começou e parou | Cobrar só o pedaço que falta, reconhecendo o que andou. |
| ❌ **NÃO FEITO** | nenhuma prova em nenhuma fonte | Se ainda é necessário, vira reincidente. Se não é mais, encerrar e dizer por quê. |
| ⚪ **PREJUDICADO** | deixou de fazer sentido | **Não é falha de ninguém.** Registrar e tirar da lista. |

⚠️ **Ausência de prova não é prova de ausência.** Ligação e áudio pessoal não deixam rastro legível.
Quando a ação só podia acontecer num canal que não dá para ler, o veredicto é 🟠 e a mensagem
**pergunta** ("conseguiu falar com ele ontem?"), nunca ❌ com acusação.

⚠️ **Conferir contra o que a mensagem realmente pediu.** Se o pedido foi "dar um status" e a pessoa
deu o status, está FEITO — mesmo que o negócio não tenha avançado.

📈 **A taxa de execução (feitos ÷ cobrados) é o indicador de saúde da rotina.** Caindo, o problema é
da rotina — lista grande demais, item vago, prioridade errada —, não da equipe. Lista de 6 itens com
5 feitos vale mais que lista de 15 com 4.

---

## 5. Validar — a etapa que separa isto de "listar card parado"

Antes de transformar qualquer situação em tarefa, conferir: datas da viagem, status, etapa, última
atualização, histórico de mudanças, tarefas, notas, Inbox, e-mail, **outras negociações do mesmo
cliente**, duplicidade, e se existe outro card representando a jornada correta.

Classificar **cada** caso:

| # | Categoria | Significa |
|---|---|---|
| 1 | **Pendência comercial real** | evidência concreta de ação comercial necessária |
| 2 | **Pendência operacional real** | pós-venda, alteração, embarque, atendimento |
| 3 | **Higiene do CRM** | etapa errada, card antigo, duplicidade — **nunca atribuir como falha do vendedor** |
| 4 | **Precisa validar** | dados insuficientes. Escrever "validar antes de cobrar" e **não cobrar ninguém** |

### As tarefas vencidas mentem

Boa parte é ruído de playbook: automação criando tarefa com vencimento no mesmo dia. Detecção:
**título repetido** e **nenhuma vencida de antes de ontem**. Cobrar por essa lista é injusto —
avisar o vendedor que pode desconsiderar e mandar a correção do playbook como problema de processo.

### Reincidência tem prova, não suspeita

Só marcar 🔴 **REINCIDENTE** quando os quatro forem verdadeiros: a ação era necessária; foi
recomendada antes; chegou ao responsável certo; não houve avanço em card, nota, etapa, tarefa,
Inbox nem e-mail. **Card continuar aberto não é reincidência.**

---

## 6. Priorizar — dinheiro primeiro, não maior valor primeiro

Ordem fixa: dinheiro que entra hoje → quase fechamento → urgência operacional → dinheiro em risco →
clientes esfriando → alto valor → recuperação com chance real → cross-sell → Inbox → e-mail →
reincidentes → processo → higiene.

> Um cliente de R$ 3.000 que pediu boleto vem antes de uma cotação inicial de R$ 40.000.

### Recuperação — classificar, nunca somar como receita

| Classe | Quando |
|---|---|
| **RECUPERAR AGORA** | necessidade ainda relevante, motivo reversível, intenção anterior |
| **NUTRIR** | potencial sem urgência ou contexto para abordar agora |
| **ENCERRAR** | prazo passou, cliente já comprou, duplicidade, sem contexto válido |

⚠️ Funil de recuperação sem classificação infla a previsão da empresa inteira. **Sempre separar no
dashboard o pipeline aparente do pipeline em disputa comercial real.**

---

## 7. Entregar

### Entrega 1 — Dashboard Executivo

Um HTML por dia, com nome datado, na pasta de dashboards, a partir de
`references/dashboard-modelo.html`. Estrutura obrigatória, nesta ordem:

1. **Cabeçalho** com a marca da casa, título e data.
2. **KPIs** — dinheiro perto do fechamento · dinheiro em risco · clientes esfriando · oportunidades
   de alto valor · cross-sell pendente · pendências reincidentes · urgências operacionais · higiene.
3. **Ontem × hoje** — logo abaixo dos KPIs, com a **taxa de execução** em destaque e uma linha por
   pessoa: ✅ feitos, 🟠 parciais, ❌ não feitos nominais, ⚪ prejudicados. É o primeiro bloco que
   a gestão lê depois dos números.
4. **Dinheiro primeiro** — tabela com Prioridade, Cliente, Funil, Etapa, Valor, Responsável,
   Evidência e Ação; ao lado, a barra com clientes esfriando, alto valor, recuperação, cross-sell,
   Inbox, e-mail, higiene e reincidentes.
5. **Ações por responsável** — uma coluna por pessoa, cada item com evidência, ação e prazo.
6. **Plano de ataque do dia** — as 5 ações de maior impacto.

⛔ **Não inventar layout novo a cada dia.** Fixar um modelo e reusar: o painel é lido em 30 segundos
antes de uma reunião, e layout que muda obriga a reaprender onde está cada coisa.

### Entrega 1b — pôr o painel na mão de quem decide

Salvar o arquivo **não é entregar**. Em sessão interativa, publicar como página e mandar o link.
Em execução automática, o arquivo é a entrega e o aviso vai por um canal que notifique de verdade.

⚠️ **Testar o canal de aviso antes de adotá-lo.** Aviso que não chega é pior que aviso nenhum,
porque dá a impressão de que alguém foi informado. Uma notificação por execução.

### Entrega 2 — mensagens individuais e relatório de gestão

Um arquivo por pessoa, mais o relatório de gestão.

**Toda mensagem abre com o resultado do último envio dela**, antes de qualquer item novo:

- O que ela fez vem **primeiro e pelo nome**. Reconhecimento genérico não vale nada.
- O que não foi feito volta com o **porquê de ainda importar hoje**, não com o dedo em riste.
- Item 🟠 vira **pergunta**, nunca acusação.
- Item ⚪ se diz em uma linha e some — a pessoa precisa saber que saiu da conta dela.
- Quem executou tudo recebe isso dito com todas as letras. Dia limpo é notícia.

Depois disso, cada item com marcador (🔴 reincidente · 🟡 prioridade de hoje · 🟢 nova
oportunidade), Cliente, Funil, Etapa, Valor, Evidência e Ação.

Quem não tiver ação real recebe a mensagem curta de "nenhuma prioridade crítica hoje" — **nunca
mensagem vazia**.

O relatório de gestão abre com a prestação de contas: tabela por pessoa com ✅ / 🟠 / ❌ / ⚪, a taxa
de execução, a data da base e a leitura do padrão (quem executa, quem trava sempre no mesmo tipo de
tarefa). Depois: o que distribuir, o que cobrar, o que corrigir, problemas de processo, problemas de
CRM e o que depende de decisão gerencial.

### Entrega 3 — as 3 do dia na agenda de quem decide

**Exatamente 3**, nunca 4. A **nº 1 é sempre comercial** — falar com cliente ou prospectar.
Cobrança, conciliação e higiene do CRM nunca são a nº 1.

Encaixar nos buracos reais da agenda (ler o dia antes), sem cobrir compromissos existentes. Separar
por natureza do bloco: horário de trabalho concentrado é para **preparar** (montar cotação, decidir,
escrever); horário com o mercado acordado é para **falar** (ligar, negociar, distribuir).

O que não couber entra no bloco como "não coube nos 3 de hoje".
⛔ Não duplicar: se já existirem os eventos do dia, **atualizar**, nunca criar em cima.

---

## 8. Enviar — só depois de revalidar

⚠️ **Revalidar cada item imediatamente antes de mandar.** Reabrir os cards que viraram cobrança e as
conversas quentes. O que foi resolvido no intervalo **sai da cobrança e vira reconhecimento**.

⛔ **Nunca enviar o dashboard completo para os colaboradores.** Cada um recebe só o que compete a
ele, em DM. Nunca mandar tarefa de um para outro, e nunca cobrança individual em grupo.

### Fechar o ciclo

Registrar no histórico de ações, com a marcação **ENVIADO EM**: o que foi cobrado de cada um, o que
foi retirado na revalidação e por quê, e o que **não** foi cobrado de propósito. Sem esse registro,
amanhã não dá para apurar reincidência.

**E fechar a conta do dia anterior no mesmo bloco:** o veredicto de cada item cobrado no envio
passado, com a prova que sustentou cada um, mais a taxa de execução. Esse é o insumo do passo 4 de
amanhã.

⚠️ **Escrever a lista de hoje em formato conferível.** Cada item precisa de dono, cliente
identificável e um verbo que dê para verificar depois — "ligar hoje para o cliente X" se prova,
"acompanhar o cliente X" não se prova. Item vago hoje é veredicto impossível amanhã.

# setup — o que preencher antes do primeiro uso

Vinte minutos, uma vez só. Vale para as duas primeiras skills. Enquanto estes campos estiverem entre chaves, a skill descreve o método
mas não sabe onde agir.

---

## 1. Constantes da operação

Copie esta tabela para o topo do `SKILL.md`, preenchida.

| Campo | O que é | Onde achar |
|---|---|---|
| `{{PASTA_DASHBOARDS}}` | Onde o painel do dia é salvo | Uma pasta na sua rede ou no disco. Um arquivo por dia, nome datado |
| `{{PASTA_ENVIOS}}` | Onde ficam as mensagens individuais do dia | Subpasta por data, um arquivo por pessoa |
| `{{ARQUIVO_HISTORICO}}` | O registro do que foi cobrado, de quem e quando | Um único `.md` que só cresce. É o insumo do passo 4 |
| `{{FUSO_NEGOCIO}}` | Fuso dos dados do CRM | Normalmente o do escritório |
| `{{FUSO_GESTAO}}` | Fuso de quem recebe o painel | Só difere se a gestão estiver em outro país |
| `{{DIAS_COM_PLANTAO}}` | Quais dias a equipe atende, e até que hora | Escala da casa |
| `{{EQUIPE}}` | Nome, função e id de cada pessoa no CRM | Tela de usuários do CRM |
| `{{CANAL_DE_DM}}` | Por onde cada pessoa recebe a mensagem dela | WhatsApp, Google Chat, Slack, e-mail |
| `{{ID_DM_POR_PESSOA}}` | O endereço técnico da conversa de cada um | Só descobre enviando uma mensagem de teste |
| `{{CANAL_DE_AVISO}}` | Por onde a gestão é avisada de que o painel ficou pronto | Ver a regra abaixo |

⚠️ **Testar o canal de aviso de verdade antes de adotá-lo.** Mandar, e a pessoa confirmar que
apitou no celular. Aviso que não chega é pior que aviso nenhum, porque dá a impressão de que alguém
foi informado.

⚠️ **Remetente igual a destinatário costuma não notificar.** Se a ferramenta autentica com a mesma
conta que vai receber, a mensagem cai em "conversa comigo mesmo" e ninguém é avisado. E-mail
costuma ser o caminho mais feio e mais confiável.

---

## 2. Estrutura de pastas

```
{{PASTA_RAIZ}}/
├── dashboards/
│   └── dashboard-comercial-AAAA-MM-DD.html
├── envios/
│   ├── AAAA-MM-DD/
│   │   ├── <pessoa-1>.txt
│   │   ├── <pessoa-2>.txt
│   │   └── gestao.md
│   └── ids-das-dms.json
└── historico-acoes.md
```

O `historico-acoes.md` é o arquivo mais importante dos três. Cada bloco começa com a marcação
**`ENVIADO EM dd/mm/aaaa hh:mm`** e traz: o que foi cobrado de cada um, o que foi retirado na
revalidação e por quê, o que **não** foi cobrado de propósito, e o veredicto de cada item do envio
anterior. Sem ele, não existe passo 4 — e sem o passo 4 a rotina vira um gerador de listas.

---

## 3. Rodar sozinha de madrugada

Só no Claude Code. A ideia: um comando que roda a skill sem ninguém no teclado, com log, e que o
sistema operacional dispara todo dia útil.

### Windows — Agendador de Tarefas

Crie um `.cmd` que chama o Claude em modo não interativo pedindo a skill, e redirecione a saída para
um arquivo de log. Depois registre a tarefa **pelo PowerShell**, não pela interface:

```powershell
$acao = New-ScheduledTaskAction -Execute "C:\caminho\analise.cmd"
$gatilho = New-ScheduledTaskTrigger -Daily -At 4am
Register-ScheduledTask -TaskName "Analise-Comercial" -Action $acao -Trigger $gatilho -RunLevel Highest
```

⚠️ **Três armadilhas que custam dias:**

1. **Modo não interativo precisa da lista de ferramentas liberadas.** Se a chamada não autorizar
   explicitamente as ferramentas do CRM **e** a própria execução de skills, a rotina roda, não
   reclama, e não faz nada. É a falha mais silenciosa de todas.
2. **Coloque tentativa repetida.** Erro de sobrecarga da API é transitório e derruba o dia inteiro.
   Três tentativas com espera crescente resolvem quase tudo. Detecte a falha por três vias, porque
   sair com código zero não garante nada: código diferente de zero, **saída vazia**, ou saída com
   texto de erro conhecido.
3. **Devolva o código de saída certo ao Agendador**, senão ele marca falha mesmo quando a segunda
   tentativa deu certo — e você passa a ignorar o alarme.

⚠️ Falhas idênticas em poucos segundos, repetidas, não são sobrecarga: são credencial ou assinatura
cortada. Confira a conta antes de mexer no script.

### macOS — launchd

Um `.plist` em `~/Library/LaunchAgents` com `StartCalendarInterval` para as 4h, apontando para um
`.sh` equivalente. Vale a mesma lista de armadilhas. E o computador precisa estar ligado: em
notebook que dorme, prefira rodar no começo do expediente em vez das 4h.

---

## 4. Primeiro teste

1. Rode a skill na mão, com você olhando.
2. **Não envie nada para a equipe na primeira vez.** Leia o painel e as mensagens individuais
   inteiras, e confira caso a caso se você cobraria aquilo de uma pessoa de verdade.
3. Corrija a skill onde ela errou o tom ou a régua. É esperado errar aqui.
4. Só depois disso ligue o envio, e comece por uma pessoa só.

A primeira semana é de calibragem. Cobrança injusta na largada queima a confiança da equipe na
rotina inteira, e ela não volta.

<!doctype html>
<html lang="pt-BR">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Dashboard Executivo Comercial {{DD/MM/AAAA}}</title>
<!--
  MODELO DO DASHBOARD EXECUTIVO COMERCIAL
  Trocar apenas: as cores em :root, o nome no cabecalho e o conteudo dos {{ }}.
  Nao mudar a ORDEM dos blocos: o painel e lido em 30 segundos antes de uma reuniao,
  e layout que muda a cada dia obriga a reaprender onde esta cada coisa.
-->
<style>
:root{
  /* cores da agencia: trocar estas quatro e o painel inteiro muda */
  --marca:#1f2a44;        /* cabecalho e bloco final */
  --marca-2:#33456e;      /* degrade do cabecalho */
  --destaque:#c9922f;     /* numero em evidencia */
  --alerta:#c0392b;       /* urgencia, risco */
  --ok:#1c8b5f;           /* feito, oportunidade */
  --info:#1a7f9c;         /* higiene, informativo */
  --fundo:#f4f6f9;
  --texto:#132033;
  --apagado:#66768c;
  --linha:#e6ebf2;
}
*{box-sizing:border-box}
body{margin:0;font-family:Arial,Helvetica,sans-serif;background:var(--fundo);color:var(--texto)}
header{background:linear-gradient(125deg,var(--marca),var(--marca-2));color:#fff;padding:28px 36px}
.brand{font-weight:900;letter-spacing:2px;font-size:13px;opacity:.85}
h1{margin:7px 0;font-size:26px}
.sub{font-size:13px;opacity:.8}
main{max-width:1450px;margin:auto;padding:22px}
.kpis{display:grid;grid-template-columns:repeat(4,1fr);gap:12px}
.card{background:#fff;border:1px solid var(--linha);border-radius:14px;padding:16px;box-shadow:0 5px 20px rgba(20,50,90,.06)}
.v{font-size:27px;font-weight:900}
.l{font-size:10px;color:var(--apagado);font-weight:800;margin-top:4px;letter-spacing:.04em}
h2{font-size:17px;margin:0 0 12px}
table{width:100%;border-collapse:collapse;font-size:12px}
th,td{padding:9px;text-align:left;border-bottom:1px solid var(--linha);vertical-align:top}
th{font-size:10px;color:var(--apagado);letter-spacing:.04em}
.money{font-weight:900;font-variant-numeric:tabular-nums}
.grid{display:grid;grid-template-columns:2fr 1fr;gap:14px;margin-top:14px}
.side{display:grid;gap:12px}
.red{border-left:4px solid var(--alerta)}
.green{border-left:4px solid var(--ok)}
.cyan{border-left:4px solid var(--info)}
.gold{border-left:4px solid var(--destaque)}
ul{list-style:none;padding:0;margin:0}
li{font-size:12px;line-height:1.45;padding:7px 0;border-bottom:1px solid var(--linha)}
li b{display:block}
.ontem{margin-top:14px}
.ontem .taxa{font-size:30px;font-weight:900;color:var(--ok)}
.ontem table td:first-child{font-weight:700}
.team{display:grid;grid-template-columns:repeat(4,1fr);gap:12px;margin-top:14px}
.team p{font-size:12px;line-height:1.5}
.attack{margin-top:14px;background:var(--marca);color:#fff;border-radius:14px;padding:18px}
.steps{display:grid;grid-template-columns:repeat(5,1fr);gap:8px}
.step{border:1px solid rgba(255,255,255,.14);border-radius:11px;padding:11px;font-size:11px}
.step b{display:block;color:var(--destaque);font-size:18px}
.note{font-size:10px;color:var(--apagado);margin-top:12px}
@media(max-width:850px){.kpis,.team{grid-template-columns:1fr 1fr}.grid{grid-template-columns:1fr}.steps{grid-template-columns:1fr 1fr}}
@media(max-width:500px){.kpis,.team,.steps{grid-template-columns:1fr}}
</style>
</head>
<body>

<!-- 1. CABECALHO -->
<header>
  <div class="brand">{{NOME DA AGENCIA}}</div>
  <h1>Dashboard Executivo Comercial</h1>
  <div class="sub">{{DD/MM/AAAA}} | Dinheiro primeiro, validacao antes da cobranca</div>
</header>

<main>

<!-- 2. OS 8 KPIs: sempre estes oito, sempre nesta ordem -->
<section class="kpis">
  <div class="card"><div class="v">{{R$}}</div><div class="l">PERTO DO FECHAMENTO</div></div>
  <div class="card"><div class="v">{{R$}}</div><div class="l">DINHEIRO EM RISCO</div></div>
  <div class="card"><div class="v">{{N}}</div><div class="l">CLIENTES ESFRIANDO</div></div>
  <div class="card"><div class="v">{{N}}</div><div class="l">OPORTUNIDADES DE ALTO VALOR</div></div>
</section>
<section class="kpis" style="margin-top:12px">
  <div class="card"><div class="v">{{N}}</div><div class="l">CROSS-SELL PENDENTE</div></div>
  <div class="card"><div class="v">{{N}}</div><div class="l">PENDENCIAS REINCIDENTES</div></div>
  <div class="card"><div class="v">{{N}}</div><div class="l">URGENCIAS OPERACIONAIS</div></div>
  <div class="card"><div class="v">{{N}}</div><div class="l">PROBLEMAS DE HIGIENE</div></div>
</section>

<!-- 3. ONTEM x HOJE: vem antes de qualquer cobranca de hoje -->
<section class="ontem card">
  <h2>Ontem x hoje</h2>
  <p style="font-size:12px;color:var(--apagado);margin:0 0 10px">
    Base: envio de {{DD/MM}}. Taxa de execucao <span class="taxa">{{X}}/{{Y}}</span>
  </p>
  <table>
    <tr><th>Pessoa</th><th>Feito</th><th>Parcial</th><th>Nao feito</th><th>Prejudicado</th><th>Leitura</th></tr>
    <tr><td>{{PESSOA}}</td><td>{{N}}</td><td>{{N}}</td><td>{{QUEM/O QUE}}</td><td>{{N}}</td><td>{{padrao observado}}</td></tr>
  </table>
</section>

<!-- 4. DINHEIRO PRIMEIRO + BARRA LATERAL -->
<section class="grid">
  <div class="card">
    <h2>Dinheiro primeiro</h2>
    <table>
      <tr><th>#</th><th>Cliente</th><th>Funil</th><th>Etapa</th><th>Valor</th><th>Dono</th><th>Evidencia</th><th>Acao</th></tr>
      <tr>
        <td>1</td><td><b>{{CLIENTE}}</b></td><td>{{FUNIL}}</td><td>{{ETAPA}}</td>
        <td class="money">{{R$}}</td><td>{{DONO}}</td>
        <td>{{o que prova que isto e prioridade}}</td><td>{{acao com verbo verificavel}}</td>
      </tr>
    </table>
  </div>
  <div class="side">
    <div class="card red"><h2>Urgencias operacionais</h2><ul><li><b>{{CLIENTE}}</b>{{prazo e o que fazer}}</li></ul></div>
    <div class="card gold"><h2>Recuperacao</h2><ul><li><b>{{CLIENTE}}, {{R$}}</b>{{recuperar agora / nutrir / encerrar}}</li></ul></div>
    <div class="card green"><h2>Cross-sell</h2><ul><li><b>{{CLIENTE}}</b>{{contexto real que justifica}}</li></ul></div>
    <div class="card cyan"><h2>Higiene do CRM</h2><ul><li><b>{{CARD}}</b>{{nunca cobrar o vendedor por isto}}</li></ul></div>
  </div>
</section>

<!-- 5. ACOES POR RESPONSAVEL: uma coluna por pessoa -->
<section class="team">
  <div class="card"><h2>{{PESSOA}}</h2><p><b>{{CLIENTE}}:</b> {{acao e prazo}}.</p></div>
  <div class="card"><h2>{{PESSOA}}</h2><p><b>{{CLIENTE}}:</b> {{acao e prazo}}.</p></div>
  <div class="card"><h2>{{PESSOA}}</h2><p><b>{{CLIENTE}}:</b> {{acao e prazo}}.</p></div>
  <div class="card"><h2>{{GESTAO}}</h2><p><b>{{TEMA}}:</b> {{decisao que so ela pode tomar}}.</p></div>
</section>

<!-- 6. PLANO DE ATAQUE: as 5 de maior impacto -->
<section class="attack">
  <h2>Plano de ataque do dia</h2>
  <div class="steps">
    <div class="step"><b>01</b>{{acao}}</div>
    <div class="step"><b>02</b>{{acao}}</div>
    <div class="step"><b>03</b>{{acao}}</div>
    <div class="step"><b>04</b>{{acao}}</div>
    <div class="step"><b>05</b>{{acao}}</div>
  </div>
</section>

<div class="note">
  Regra aplicada: nenhum card vira cobranca apenas pela etapa. Caso inconclusivo exige validacao
  antes de cobrar a equipe.
</div>

</main>
</body>
</html>

---
name: criar-skill
description: 'Transforma um processo que você repete toda semana numa skill que o Claude passa a executar sozinho — entrevista você sobre o método, escreve o arquivo SKILL.md completo, testa e diz onde salvar. Use quando disserem "quero criar uma skill", "vira isso numa skill", "toda vez eu tenho que explicar de novo como faço X", "automatiza esse processo", ou ao invocar /criar-skill. NÃO use para executar o processo em si, só para escrevê-lo.'
---

# criar-skill — vire seu processo em skill

Uma skill é o método da sua casa escrito por extenso, num arquivo de texto. Quando alguém pede algo
que bate com a descrição dela, o Claude carrega o método inteiro e passa a seguir aquilo em vez de
improvisar. Esta skill existe para escrever as outras.

**Não escreva a skill sozinho no editor.** Converse: quem tem o método é a pessoa, quem sabe a forma
é o Claude. O trabalho aqui é extrair.

---

## 1. Descobrir se vale virar skill

Vale quando a resposta é sim para as três:

1. **Você repete isso?** Toda semana, todo dia, ou toda vez que entra cliente novo.
2. **Existe um jeito certo de fazer?** Se cada vez é diferente e depende de julgamento puro, não é
   skill, é conversa.
3. **Explicar leva mais de dois minutos?** Se cabe numa frase, não precisa de arquivo.

⛔ **Não vale:** tarefa que você faz uma vez só, decisão que muda toda semana, ou algo que depende
de informação que só existe na sua cabeça no momento.

---

## 2. Entrevistar quem tem o método

Perguntar **uma coisa de cada vez** e esperar a resposta. Perguntar tudo junto devolve resposta
rasa, e skill rasa não muda nada.

| # | Pergunta | Vira o quê no arquivo |
|---|---|---|
| 1 | Quando você faria isso? Que frase você usaria ao pedir? | a descrição, que é o que dispara a skill |
| 2 | Qual o primeiro passo, na prática? | a seção 1 |
| 3 | E depois? (repetir até acabar) | as seções seguintes |
| 4 | Onde você busca a informação? | as fontes e as chamadas |
| 5 | O que você olha para decidir a ordem? | a tabela de priorização |
| 6 | O que já deu errado aqui? | as armadilhas |
| 7 | O que ninguém pode fazer sem falar com você? | o que exige autorização |
| 8 | Como você sabe que terminou bem? | o fecho |

⭐ **A pergunta 6 é a que faz a skill valer.** Método bonito qualquer um escreve; o que separa uma
skill útil é a lista do que já custou dinheiro. Insistir nela: "o que você fez uma vez e não faria
de novo?"

---

## 3. Escrever o arquivo

Um arquivo só, chamado `SKILL.md`, dentro de uma pasta com o nome da skill.

```
---
name: nome-da-skill
description: 'O que ela faz, em uma frase. Depois: Use quando disserem "frase 1",
  "frase 2", ou ao invocar /nome-da-skill. NÃO use para (o caso vizinho que confunde).'
---

# nome-da-skill — o que ela entrega

Uma linha dizendo o objetivo real. Não o que ela lê, o que ela resolve.

## 0. Constantes
Os dados da casa: ids, canais, links, prazos.

## 1..N. Os passos, na ordem
Cada um com o que fazer e como saber que deu certo.

## Armadilhas
O que já deu errado, e o que fazer em vez disso.

## O que exige autorização
A lista curta do que a skill nunca faz sozinha.
```

### A descrição é a parte mais importante

É por ela que o Claude decide usar a skill. Descrição vaga faz a skill nunca disparar, ou disparar
na hora errada.

- ✅ **Escreva as frases que a pessoa realmente diz**, com as palavras dela.
- ✅ **Diga também quando NÃO usar**, apontando a skill vizinha. É o que evita duas skills brigando.
- ⛔ Não escreva "ajuda com atendimento". Escreva o gatilho.

### Escreva como quem ensina alguém no primeiro dia

Frase curta. Verbo no imperativo. Número exato em vez de "alguns". Se existe uma ordem, numere. Se
existe uma escolha, faça tabela com o sinal na esquerda e a decisão na direita.

⚠️ **Toda regra vem com o porquê.** "Nunca cobre alguém sem conferir a prova" se cumpre; a mesma
regra com "porque errar isso queima a confiança da equipe e ela não volta" se defende sozinha quando
aparecer o caso que a regra não previu.

---

## 4. Deixar os dados de fora

Nunca escreva senha, token ou dado de cliente dentro da skill. Para o que muda de casa para casa,
use um campo entre chaves duplas e uma tabela dizendo onde achar:

```
| Campo | Onde achar |
|---|---|
| {{ID_DO_FUNIL}} | Tela de funis do CRM |
```

Assim a mesma skill serve para outra pessoa, e você pode passá-la adiante sem revisar linha a linha.

---

## 5. Onde salvar

| Onde você usa | Onde o arquivo fica |
|---|---|
| Claude Code no Windows | `C:\Users\SEU-USUARIO\.claude\skills\nome-da-skill\SKILL.md` |
| Claude Code no Mac | `~/.claude/skills/nome-da-skill/SKILL.md` |
| Claude Desktop ou navegador | compacte a pasta em `.zip` e suba em Configurações, Capacidades, Skills |

Depois de salvar no Claude Code, feche e abra de novo. Teste digitando `/nome-da-skill`.

⚠️ No Desktop, o `.zip` precisa ter a **pasta** na raiz e o `SKILL.md` um nível abaixo. E as
capacidades de execução de código e criação de arquivos precisam estar ligadas.

---

## 6. Testar antes de confiar

1. Peça algo que **deveria** disparar a skill, com as suas palavras. Ela apareceu?
2. Peça algo parecido que **não** deveria disparar. Ela ficou quieta?
3. Rode uma vez inteira olhando cada passo. Onde ela improvisou, faltou regra no arquivo.
4. Corrija o arquivo. É esperado corrigir nas primeiras vezes.

⭐ **Skill boa nasce errada e é corrigida no uso.** Toda vez que ela fizer algo que você não faria,
não explique de novo na conversa: escreva no arquivo. É a diferença entre ensinar uma vez e ensinar
para sempre.

---

## Fecho

Terminar dizendo: o que a skill faz, onde o arquivo ficou, e qual a primeira coisa que a pessoa deve
pedir para ela amanhã.