Agent skill

Deskcomm Prompt

by melgarafael in melgarafael/DeskcommCRM

Guia para afinar o prompt de um agente de IA do DeskcommCRM que não está performando — como um engenheiro de prompt sênior de atendimento e vendas, com dados da operação, não achismo.

MITAuto-check passedSales & Support

Install Deskcomm Prompt

skills CLI
$ npx skills add melgarafael/DeskcommCRM --skill deskcomm-prompt -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install melgarafael/DeskcommCRM deskcomm-prompt --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/melgarafael/DeskcommCRM.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/deskcomm-prompt .claude/skills/deskcomm-prompt && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
deskcomm-prompt
GitHub stars
4.5k
Token cost
~1.4k tokens
SKILL.md length
776 words
Files
4 (incl. references)
Skills in repo
8
Repo updated
First seen
Licence
MIT

At a glance

Guia para afinar o prompt de um agente de IA do DeskcommCRM que não está performando — como um engenheiro de prompt sênior de atendimento e vendas, com dados da operação, não achismo.

  • Sales & Support work in your project
  • SKILL.md covers Como você age, Passo 0 — o que a pessoa vê, Passo 1 — o diagnóstico and Passo 2 — a revisão do prompt, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Deskcomm Prompt is an agent skill from melgarafael/DeskcommCRM. Guia para afinar o prompt de um agente de IA do DeskcommCRM que não está performando — como um engenheiro de prompt sênior de atendimento e vendas, com dados da operação, não achismo. Use SEMPRE que alguém disser "o agente responde errado", "está robótico", "passa tudo para humano", "não usa a agenda", "inventa preço", "fala demais", "não converte", "melhora o prompt", "otimiza o agente", ou quiser revisar, reescrever ou comparar versões do prompt. Diagnostica pelas execuções, vetos e custos, propõe a versão nova…

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including reference files (for example `agents/openai.yaml`, `references/anatomia-e-antipadroes.md` and `references/diagnostico.md`).

It sits in Sales & Support. It works with WhatsApp. The repository describes itself as: Open-source AI sales OS — self-hosted CRM with native AI agents + WhatsApp (WAHA). Open alternative to Kommo, Octadesk & Intercom for any business that sells by chat. MCP-ready… The licence is MIT.

When your agent uses it

  • Sales & Support work in your project

Example prompts

  • “o agente responde errado”
  • “está robótico”
  • “passa tudo para humano”
  • “/deskcomm-prompt”

What it can do on your machine

Read from SKILL.md and the folder at commit b3bd604. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Deskcomm Prompt loads about 1.4k tokens when it runs, and up to ~4.2k if it reads all its reference files. Until then it costs about 151 tokens; SKILL.md has 776 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~151
When it runs · the whole SKILL.md, loaded when a task matches
~1.4k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~4.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from melgarafael/DeskcommCRM at commit b3bd604, republished under its MIT licence (© melgarafael). 776 words, ~1,427 tokens.

Download SKILL.mdSave it as .claude/skills/deskcomm-prompt/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
deskcomm-prompt
description
Guia para afinar o prompt de um agente de IA do DeskcommCRM que não está performando — como um engenheiro de prompt sênior de atendimento e vendas, com dados da operação, não achismo. Use SEMPRE que alguém disser "o agente responde errado", "está robótico", "passa tudo para humano", "não usa a agenda", "inventa preço", "fala demais", "não converte", "melhora o prompt", "otimiza o agente", ou quiser revisar, reescrever ou comparar versões do prompt. Diagnostica pelas execuções, vetos e custos, propõe a versão nova em rascunho, testa pelo botão Testar e deixa o Publicar com a pessoa.
metadata.publico
dono do negócio, agência, implantador
metadata.regra
o prompt do agente é UMA camada; o motor injeta o resto e barra na saída

Afinar o prompt de um agente com dados

"O agente está ruim" quase nunca é o prompt inteiro. Às vezes é o roteador mandando para o agente errado; às vezes é um portão de saída vetando por vocabulário que o próprio prompt ensinou; às vezes é a base de conhecimento que não cobre; às vezes é o horário. Otimizar prompt sem olhar os dados troca um problema por outro. Este guia diagnostica primeiro.

Como você age

  • Sabe o que o prompt controla e o que não controla. O texto do agente é uma camada dentro de um prompt montado pelo motor, e onze portões barram a resposta na saída. Reescrever regra que o motor já impõe é ruído; escrever jargão ou "encaminhe ao gerente" cria veto e mata a agenda. Lista completa em references/anatomia-e-antipadroes.md.
  • Diagnóstico antes da reescrita. Execuções, vetos, handoffs, consultas à base, custo por turno: references/diagnostico.md. Só depois disso você abre o prompt.
  • Amostra mínima de conversa, com ciência da pessoa. Ler mensagens é ler dado pessoal de terceiros. Quando for indispensável, poucas conversas, só o trecho, só na instalação, e a pessoa sabe. Preferir agregados (o guia deskcomm-metricas cobre).
  • Versão nova, nunca edição. A otimização vira uma versão em rascunho, testada pelo botão Testar com o mesmo roteiro antes e depois; o clique em Publicar é da pessoa. Versão publicada é imutável e reversível.
  • Uma mudança por vez, medida. Trocar cinco coisas e a conversão subir não ensina nada.

Passo 0 — o que a pessoa vê

Uma pergunta por vez: qual agente; o que acontece (a frase exata que incomoda, se houver); desde quando; o que mudou perto disso (versão publicada, materiais, roteador, número novo). Descubra a versão publicada e a data — as métricas comparam "antes/depois" por essa data.

Passo 1 — o diagnóstico

Rode o bloco de references/diagnostico.md: vetos por portão nas execuções recentes (se o veto é internal_vocabulary ou promise, a origem costuma ser o prompt); handoffs e casos (passa demais ou de menos); consultas à base sem acerto (material que falta × limiar); roteador errando (intenções, não prompt); custo e tamanho do turno; fora da janela. Cada sinal aponta para uma causa — e nem toda causa é prompt.

sinalcausa provávelonde mexer
vetos de vocabulário internoprompt cita ferramenta, "lead", etapa, sistemaprompt
vetos de promessaprompt permite desconto/prazo que a tabela não permite (ou a tabela não existe)prompt + tabela de promessas
"vou confirmar com o gerente" e agenda paradaprompt manda encaminhar tudo a uma pessoa nomeadaprompt
base sem acerto com score perto do limiarlimiar apertadoajuste avançado (técnico)
base sem acerto com score baixomaterial não cobreconhecimento, não prompt
agente errado respondeuintenções do roteadorroteador
respostas longas, custo altoprompt gigante (o turno custa ao menos duas chamadas)prompt: cortar o que o motor já faz
some à noitehorário do agenteconfiguração, não prompt
Show full SKILL.md (299 more words)Show less

Passo 2 — a revisão do prompt

Com o diagnóstico, abra a versão publicada e revise contra o checklist de references/anatomia-e-antipadroes.md: o que está lá e o motor já impõe (corte); o que está lá e cria veto (reescreva); o que falta (diagnóstico antes da oferta, situações, quando usar capacidade, limites por situação); tom e tamanho. Conteúdo situacional (objeção de preço, reativação) vai para skill do produto, não para o prompt — o corpo só entra quando o assunto aparece.

Escreva a versão nova inteira em prompt-<agente>-v<N>.md com um bloco "o que mudou e por quê", uma linha por mudança, ligada ao sinal do diagnóstico.

Passo 3 — antes/depois pelo botão Testar

Monte 5 a 8 mensagens do nicho (o guia deskcomm-cliente-novo tem roteiros) cobrindo o que incomodava. Rode cada uma na versão publicada e na versão nova (rascunho) pelo botão Testar: compare texto, ações tentadas e portões. Registre a tabela em references/diagnostico.md (seção "antes/depois"). Se a nova não melhora onde doía, não publique — volte ao diagnóstico.

Passo 4 — publicar (a pessoa) e medir (você, depois)

A pessoa clica em Publicar. Anote a data e a versão. Em 7 a 14 dias, o guia deskcomm-metricas compara handoffs, vetos, custo por turno e conversão antes/depois da data da publicação — é a única prova de que a otimização valeu. Piorou? Reverter cria uma versão a partir da anterior em segundos.

O que você nunca faz

  • Não edita a tabela do agente no banco (o motor ignora; a rota barra).
  • Não publica sem a pessoa ver o antes/depois.
  • Não troca modelo, provedor ou credencial "de brinde" — é outra mudança, medida à parte.
  • Não escreve no prompt regra que é portão do motor, nem nome de ferramenta, nem placeholder {{assim}}.
  • Não conclui pela conversa de um cliente só. Uma frase ruim é anedota; padrão é dado.

© melgarafael, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (references) in .agents/skills/deskcomm-prompt of melgarafael/DeskcommCRM.

  • SKILL.md
  • agents/openai.yaml
  • references/anatomia-e-antipadroes.md
  • references/diagnostico.md

Open the folder on GitHubat commit b3bd604

Compare with similar skills

Deskcomm Prompt next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Deskcomm Prompt compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Deskcomm Prompt this skillmelgarafael/DeskcommCRM4.5k—~1.4kAutomated safety check: PassMIT
B2b Sdr AgentiPythoning/b2b-sdr-agent-template190—~744Automated safety check: PassMIT-0
Lead DiscoveryiPythoning/b2b-sdr-agent-template190—~961Automated safety check: PassMIT
Cashclaw Whatsapp Managerertugrulakben/cashclaw303—~2.5kAutomated safety check: PassMIT
Service Omni Channel Inventory Analyzeforcedotcom/sf-skills1.1k—~1.2kAutomated safety check: NotesApache-2.0
Marketing Message Testforcedotcom/sf-skills1.1k—~5.1kAutomated safety check: PassApache-2.0

Similar skills

  • B2b Sdr Agent

    iPythoning/b2b-sdr-agent-template

    Open-source B2B AI SDR template. An agent skill from iPythoning/b2b-sdr-agent-template.

    190 GitHub stars~744 tokensUpdated 11 days ago
    Sales & SupportAuto-check passed
  • Lead Discovery

    iPythoning/b2b-sdr-agent-template

    AI-driven lead discovery for B2B export. An agent skill from iPythoning/b2b-sdr-agent-template.

    190 GitHub stars~961 tokensUpdated 11 days ago
    Sales & SupportAuto-check passed
  • Cashclaw Whatsapp Manager

    ertugrulakben/cashclaw

    Sets up and manages WhatsApp Business accounts including auto-response systems, client communication workflows, FAQ templates, and broadcast campaigns.

    303 GitHub stars~2.5k tokensUpdated 4 days ago
    Sales & SupportAuto-check passed
  • A skill your agent uses to inventory configured Omni-Channel instances across Voice, Email, Chat, SMS, Facebook, WhatsApp, and In-App, including each channel's Queue, Flow, or Other routing target…

    1.1k GitHub stars~1.2k tokensUpdated yesterday
    Sales & SupportAuto-check: notes
  • Marketing Message Test

    forcedotcom/sf-skills

    Salesforce Marketing Cloud / Engagement 360 message preview and test-send.

    1.1k GitHub stars~5.1k tokensUpdated yesterday
    Sales & SupportAuto-check passed
  • Service De Waba Integrate

    forcedotcom/sf-skills

    Confirm the customer's WhatsApp Business Account is shared with Salesforce on Meta's side.

    1.1k GitHub stars~3.7k tokensUpdated yesterday
    Sales & SupportAuto-check passed

More from melgarafael/DeskcommCRM

All 8 skills in this repo
  • Deskcomm Contribuir

    melgarafael/DeskcommCRM

    Guia de contribuição ao DeskcommCRM para quem vai mexer no código e abrir um pull request, sobretudo de um fork.

    4.5k GitHub stars~3.6k tokensUpdated today
    Auto-check: notes
  • Deskcomm Extensao

    melgarafael/DeskcommCRM

    Guia para criar uma extensão do DeskcommCRM — o pacote declarativo — em vez de abrir um PR no núcleo.

    4.5k GitHub stars~2.7k tokensUpdated today
    Auto-check passed
  • Deskcomm Metricas

    melgarafael/DeskcommCRM

    Guia de análise das métricas de uma instalação do DeskcommCRM como um analista de dados experiente — conversão, funil, tempo de resposta, handoff, follow-ups, custo de IA, motivos de perda, horários…

    4.5k GitHub stars~1.6k tokensUpdated today
    Auto-check: notes
  • Sistema Vivo

    melgarafael/DeskcommCRM

    Doutrina de arquitetura do Sistema Vivo — o método para construir software em que nada morre por falta de resposta, resolução ou visibilidade.

    4.5k GitHub stars~2.3k tokensUpdated today
    Auto-check passed
  • Deskcomm Cliente Novo

    melgarafael/DeskcommCRM

    Guia para montar um cliente novo no DeskcommCRM por nicho — clínica, imobiliária, serviços/agência, curso/infoproduto, loja, escritório de advocacia — criando os agentes de IA, roteadores…

    4.5k GitHub stars~1.9k tokensUpdated today
    Auto-check passed
  • Deskcomm Operacao

    melgarafael/DeskcommCRM

    Guia de operação diária do DeskcommCRM para quem já tem o sistema instalado e precisa encontrar telas, entender fluxos, configurar recursos correntes e resolver dúvidas de uso sem mexer no código.

    4.5k GitHub stars~826 tokensUpdated today
    Auto-check passed

Works with

Categories

Questions about Deskcomm Prompt

What does Deskcomm Prompt do?

Guia para afinar o prompt de um agente de IA do DeskcommCRM que não está performando — como um engenheiro de prompt sênior de atendimento e vendas, com dados da operação, não achismo. Deskcomm Prompt is an agent skill from melgarafael/DeskcommCRM. Guia para afinar o prompt de um agente de IA do DeskcommCRM que não está performando — como um engenheiro de prompt sênior de atendimento e vendas, com dados da operação, não achismo.

When should I use Deskcomm Prompt?

Deskcomm Prompt fits situations like: sales & Support work in your project.

How do I install Deskcomm Prompt in Claude Code?

Run `npx skills add melgarafael/DeskcommCRM --skill deskcomm-prompt -a claude-code`. Or copy the skill folder (.agents/skills/deskcomm-prompt in melgarafael/DeskcommCRM) into .claude/skills/deskcomm-prompt in your project. Claude Code loads it when a task matches its description.

How do I install Deskcomm Prompt in Codex?

Run `npx skills add melgarafael/DeskcommCRM --skill deskcomm-prompt -a codex`. Or copy the skill folder (.agents/skills/deskcomm-prompt in melgarafael/DeskcommCRM) into .agents/skills/deskcomm-prompt in your project. Codex loads it when a task matches its description.

Can I use Deskcomm Prompt in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add melgarafael/DeskcommCRM --skill deskcomm-prompt -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/deskcomm-prompt, .gemini/skills/deskcomm-prompt, .github/skills/deskcomm-prompt and .opencode/skills/deskcomm-prompt in your project.

What does Deskcomm Prompt need to run?

SKILL.md names no scripts, command-line tools or credentials: Deskcomm Prompt is instructions for the agent only.

Does Deskcomm Prompt access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Deskcomm Prompt safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Deskcomm Prompt use?

Deskcomm Prompt is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Deskcomm Prompt use?

About 1.4k tokens (SKILL.md is roughly 5.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2.7k tokens, read only when the agent opens those files.

What are the alternatives to Deskcomm Prompt?

Skills that share tags, products or a category with Deskcomm Prompt: B2b Sdr Agent (iPythoning/b2b-sdr-agent-template, 190 stars), Lead Discovery (iPythoning/b2b-sdr-agent-template, 190 stars), Cashclaw Whatsapp Manager (ertugrulakben/cashclaw, 303 stars) and Service Omni Channel Inventory Analyze (forcedotcom/sf-skills, 1.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Deskcomm Prompt?

melgarafael (a GitHub user) maintains it in melgarafael/DeskcommCRM, which has 4,530 GitHub stars. The repository holds 8 skills in this directory. The repository was last updated on October 11, 2026.

Source: melgarafael/DeskcommCRM on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.