CursoInstalar

Guias do assistente

O seu assistente de código já sabe trabalhar no DeskcommCRM.

Os guias ensinam Claude Code, Codex, Cursor, Antigravity e OpenCode a instalar, montar um cliente, ler as métricas, afinar o agente de IA, contribuir com o código e manter o curso atualizado — seguindo as regras do projeto. Você não precisa decorar nome nenhum: diga o que quer e o guia certo entra sozinho.

curl -fsSL https://raw.githubusercontent.com/melgarafael/DeskcommCRM/main/scripts/instalar-guias.sh | bash
Instalar os guiasVer os guias

Como funciona

  1. 1

    Instale uma vez

    Um comando deixa os guias disponíveis em qualquer pasta do seu computador, para todos os assistentes.

  2. 2

    Abra uma sessão nova

    Os assistentes leem os guias quando a sessão começa. Uma conversa que já estava aberta não vê o que acabou de chegar.

  3. 3

    Peça do seu jeito

    “O agente está respondendo errado.” O assistente reconhece o assunto e segue o guia. Se preferir, chame pelo nome.

Os guias

Um guia para cada trabalho.

Há guias para quem instala e opera o CRM, sem exigir programação, e guias para quem contribui com o código ou mantém o curso.

Instalar e operar

/deskcomm-instalar

Para quem usa o CRM

Coloca o CRM no ar numa VPS e cuida dele depois: atualização, backup, domínio, WhatsApp e os erros da instalação.

O que ele faz

  • Conduz a instalação passo a passo e roda os scripts do kit.
  • Resolve cadeado/SSL, DNS, Supabase, proxy e chave de IA.
  • Atualiza, faz backup e restaura.

Peça assim

  • “quero instalar o CRM na minha VPS”
  • “o cadeado do site não aparece”
  • “como faço backup?”

Para quem: Quem instala, mesmo sem ser técnico, agências e quem opera uma VPS.

Ver o guia no GitHub

Montar um cliente

/deskcomm-cliente-novo

Para quem usa o CRM

Monta o atendimento de um cliente pelo nicho — clínica, imobiliária, serviços, curso, loja — na ordem certa e pela tela.

O que ele faz

  • Cria agentes de IA, roteadores e follow-ups.
  • Sobe a base de conhecimento e monta o funil.
  • Entrega o texto pronto para colar e conduz até o teste.

Peça assim

  • “configura o CRM para uma clínica”
  • “que prompt eu uso no agente da imobiliária?”
  • “terminei o onboarding, e agora?”

Para quem: Donos de negócio, agências e quem implanta para terceiros.

Ver o guia no GitHub

Analisar as métricas

/deskcomm-metricas

Para quem usa o CRM

Lê a operação como um analista experiente: conversão, funil, tempo de resposta, passagem para humano e custo de IA.

O que ele faz

  • Mostra onde o funil trava e por que a conversão caiu.
  • Diz quanto a IA custa e em que horário os clientes mais falam.
  • Declara a régua e o fuso de cada número.

Peça assim

  • “o agente está vendendo?”
  • “por que a conversão caiu?”
  • “quanto estou gastando com IA?”

Para quem: Donos de negócio, agências e operadores.

Ver o guia no GitHub

Afinar o agente de IA

/deskcomm-prompt

Para quem usa o CRM

Melhora o prompt de um agente que não está indo bem, como um engenheiro de prompt sênior — com os dados da operação.

O que ele faz

  • Diagnostica pelas execuções, bloqueios e custos do agente.
  • Escreve a versão nova como rascunho e testa pelo botão Testar.
  • Deixa o Publicar com você.

Peça assim

  • “o agente está robótico”
  • “ele inventa preço”
  • “melhora o prompt do agente de vendas”

Para quem: Donos de negócio, agências e quem implanta.

Ver o guia no GitHub

Contribuir com o código

/deskcomm-contribuir

Para quem programa

Confere antes do pull request o que o mantenedor confere depois — e evita retrabalho e PR recusado.

O que ele faz

  • Avisa quando a branch está atrasada em relação à main.
  • Cobra migration, teste que falta e fragmento de release.
  • Mostra como provar a mudança pela tela.

Peça assim

  • “vou abrir um PR”
  • “minha branch está atrasada?”
  • “por que o CI ficou vermelho?”

Para quem: Quem contribui, sobretudo a partir de um fork, e devs de agência.

Ver o guia no GitHub

Seguir as regras do código

/deskcomm-doutrina

Para quem programa

Aponta as regras que não se negociam neste repositório sempre que alguém escreve ou revisa código.

O que ele faz

  • Isolamento entre empresas com RLS.
  • Migration, baseline e manifesto andando juntos.
  • O que muda para quem já instalou numa VPS.

Peça assim

  • “revisa este código”
  • “como crio uma migration aqui?”
  • “posso adicionar esta coluna?”

Para quem: Qualquer pessoa ou IA escrevendo código no projeto.

Ver o guia no GitHub

Manter o curso atualizado

/deskcomm-curso

Para quem programa

A IA revisa aulas, traduções e capturas depois de mudanças no CRM, na sessão em que você faz o pedido, com os scripts do projeto. O curso em inglês continua usando fotos em português.

O que ele faz

  • Planeja a revisão desde o commit do último curso publicado e confere as mudanças nas telas.
  • Revê aulas e traduções, recaptura só as telas afetadas em português e espanhol e mede de novo as setas e os cliques.
  • Revisa o resultado no navegador e prepara PRs com os checks dos dois repositórios; verifica o deploy depois da publicação aprovada.
  • Acione com /deskcomm-curso no Claude Code ou $deskcomm-curso no Codex, seguido do pedido.

Peça assim

  • “Atualize o curso após a última versão”
  • “revise as aulas afetadas por esta mudança”
  • “atualize as capturas em espanhol”

Para quem: Mantenedores do curso e contribuidores do projeto, no clone do código.

Ver o guia no GitHub

No seu assistente

Como usar em cada um.

Todos seguem o mesmo padrão aberto de guias (Agent Skills) e acionam o guia sozinhos pelo assunto. Muda onde procuram e como chamar pelo nome.

Onde procura

Na pasta .claude/skills do projeto e na sua pasta pessoal.

  • Projeto.claude/skills/
  • Global~/.claude/skills/
Sozinho
Lê a descrição de cada guia e aciona o que combina com o seu pedido.
Pelo nome

Digite a barra e o nome. O que vier depois vai junto para o guia.

/deskcomm-instalar meu domínio é crm.minhaempresa.com.br
Ver a lista

Mostra todos os guias carregados.

/skills

Outro assistente? Quem segue o padrão Agent Skills — como GitHub Copilot e Gemini CLI — costuma ler a pasta .agents/skills, e o instalador também liga os guias em ~/.agents/skills.

Instalar

Dois jeitos de ter os guias.

Quem ainda não clonou o projeto, ou trabalha em outra pasta, usa o instalador. Quem já está num clone atualizado já tem tudo.

Em qualquer pasta

Recomendado

Cola no terminal do seu computador — não na VPS. Funciona antes de clonar o projeto.

curl -fsSL https://raw.githubusercontent.com/melgarafael/DeskcommCRM/main/scripts/instalar-guias.sh | bash
  • Guarda uma cópia só dos guias em ~/.deskcomm/guias.
  • Liga cada guia nas pastas que os assistentes leem: ~/.claude/skills, ~/.agents/skills e ~/.gemini/config/skills.
  • Nunca apaga uma skill sua com o mesmo nome: avisa e pula.

Para atualizar, rode o mesmo comando de novo.

Para desfazer:

curl -fsSL https://raw.githubusercontent.com/melgarafael/DeskcommCRM/main/scripts/instalar-guias.sh | bash -s -- --remover

Dentro de um clone

Os guias moram no próprio repositório. Abra o assistente na pasta do projeto e eles já estão lá.

git clone https://github.com/melgarafael/DeskcommCRM.git
cd DeskcommCRM
  • Ficam em .agents/skills, com uma cópia em .claude/skills para o Claude Code.
  • Mantenha a sua branch atualizada com a main: numa branch antiga, os guias também são os antigos.

No Windows, rode pelo Git Bash quando o assistente está instalado no próprio Windows. Pelo WSL, só se o assistente também roda dentro do WSL: lá a pasta pessoal é a do Linux, que os programas do Windows não leem. Onde o sistema não cria atalhos de pasta, o instalador copia os guias — aí rode o comando de novo sempre que quiser atualizar.

Para quem contribui

Mexer num guia.

Os guias são código do projeto: entram por pull request e têm teste.

  1. 1

    Edite a fonte

    O arquivo é .agents/skills/<guia>/SKILL.md. Deixe a descrição do cabeçalho entre aspas: dois-pontos soltos quebram a leitura em assistentes mais rígidos, e o guia some sem aviso.

  2. 2

    Atualize o espelho

    Copia os guias para .claude/skills, que é a pasta do Claude Code.

    pnpm skills:sync
  3. 3

    Rode o teste

    Reprova cabeçalho inválido, espelho desatualizado e descrição longa demais.

    pnpm test:unit tests/unit/skills-embutidas.test.ts
  4. 4

    Teste a sua versão

    No Claude Code, um guia instalado na pasta global vence o do projeto. Aponte o instalador para o seu clone antes de testar.

    bash scripts/instalar-guias.sh --fonte .

Perguntas frequentes

Preciso saber o nome do guia?

Não. O assistente escolhe o guia pelo assunto do que você pede. O nome serve para quando você quer ter certeza de qual guia vai entrar.

O assistente vai mexer no meu servidor sozinho?

Ele segue as permissões do seu assistente: comandos pedem a sua confirmação, a menos que você tenha liberado. No guia de prompt, publicar a versão nova do agente é sempre com você.

Os guias leem as conversas dos meus clientes?

O de métricas, não: lê o banco só com consultas que somam e contam, sem abrir o texto das mensagens nem dado pessoal. O de prompt pode ler um trecho quando é indispensável para ver como o agente fala, e só com você sabendo: as mensagens que o próprio agente enviou em poucas conversas recentes — não as do cliente —, sem copiar nada para fora da sessão.

Funciona se eu escrever em inglês ou espanhol?

Sim. Os guias são escritos em português, e o assistente segue o guia respondendo no idioma em que você escreve.

Já tenho uma skill com o mesmo nome. E agora?

O instalador não toca nela: avisa que pulou e segue com os outros guias.

Instalei e o guia não aparece.

Abra uma sessão nova do assistente. No Antigravity, confirme também que você confia na pasta do projeto: ali, pasta não confiável não carrega os guias dela.