Pular para o conteúdo

Skills para agentes

Uma skill é um pacote de instruções e pequenos programas que o seu agente de IA carrega para fazer um trabalho bem feito. O servidor MCP dá ao agente as ferramentas do Turbo Notify. A skill ensina o agente a usá-las para um fim específico, com as regras de segurança já prontas.

As skills do Turbo Notify ficam em um só plugin, turbo-notify, no repositório público turbo-notify/agent-skills (abre em nova aba) . Você pode ler tudo o que elas fazem antes de instalar.

Skills disponíveis

SkillPara quê
virtual-attendantAtender os clientes de uma empresa no WhatsApp, com memória por cliente, aprovação de uma pessoa e comandos pelo próprio WhatsApp. Veja o atendente virtual de WhatsApp.

Instale

Claude Code

claude plugin marketplace add turbo-notify/agent-skills#v1
claude plugin install turbo-notify@turbo-notify

Claude Desktop e Cowork: em Customize, aba Plugins, clique em Add, Add marketplace, Add from a repository e informe turbo-notify/agent-skills. Depois, em Discover, escolha turbo-notify e clique em Add.

Codex

codex plugin marketplace add turbo-notify/agent-skills --ref v1
codex plugin add turbo-notify@turbo-notify

Antigravity

agy plugin install https://github.com/turbo-notify/agent-skills

O plugin já declara o servidor MCP, então não há nada para adicionar: entre com a sua conta do Turbo Notify na primeira vez que o agente usar. Para um atendente que roda sozinho, conecte o servidor com uma chave de API, como o guia do atendente virtual explica.

O #v1 e o --ref v1 mantêm você na versão 1.x: uma mudança que quebra compatibilidade (versão 2) nunca chega sozinha.

Outros agentes e outras formas de usar o Turbo Notify

Agentes que leem o formato Agent Skills (OpenCode, Cursor, Copilot, Hermes e outros) instalam a skill com:

npx skills add turbo-notify/agent-skills

O Hermes Agent também instala pelo nome: hermes skills install turbo-notify/agent-skills/skills/virtual-attendant. Esses agentes não leem o plugin, então adicione o servidor MCP https://mcp.turbonotify.com nas configurações deles.

  • Só o servidor MCP. O servidor está no registro oficial de MCP como com.turbonotify/whatsapp, para os agentes que descobrem servidores por lá. Veja Servidor MCP.
  • n8n. O nó da comunidade n8n-nodes-turbo-notify envia e recebe mensagens do WhatsApp em fluxos do n8n. No n8n, abra Settings, Community nodes e instale com esse nome. O código está em turbo-notify/n8n-nodes-turbo-notify (abre em nova aba) .

Atualização

Os marketplaces de terceiros não atualizam sozinhos em todos os agentes. Por isso a skill confere a própria versão cerca de uma vez por hora e, quando existe uma nova, avisa os administradores por mensagem, com o comando certo para o agente em uso.

Claude Code

claude plugin marketplace update turbo-notify
claude plugin update turbo-notify@turbo-notify

Reinicie depois. Para atualizar sozinho, ative a atualização automática em /plugin, na aba Marketplaces.

Claude Desktop e Cowork: o marketplace sincroniza pelo repositório. A documentação do Claude não descreve um botão de atualização manual: se a versão nova não aparecer, remova o marketplace na página de Plugins e adicione de novo. Um plugin enviado como arquivo não atualiza: instale pelo marketplace.

Codex

codex plugin marketplace upgrade
codex plugin add turbo-notify@turbo-notify

Antigravity: rode de novo o comando de instalação. Ele substitui a cópia instalada.

Depois de atualizar, a pasta de dados é ajustada para a versão nova. Se você usa o executor, pare-o (Ctrl+C) e inicie de novo: é nesse momento que o ajuste acontece. Antes de qualquer ajuste ela faz uma cópia de segurança, e a pasta fica como estava se algo falhar. Não edite os arquivos da skill instalada: as alterações se perdem na atualização. O que você ensinou ao atendente virtual e as suas regras ficam na pasta de dados, e são mantidos.

O que uma skill acessa

  • O Turbo Notify, pelo servidor MCP (o que o plugin declara, ou o que você conectou com uma chave), com as permissões da sua conta ou da chave.
  • Uma pasta no seu computador, a que você escolhe na configuração, onde ficam as conversas, as fichas e o que você ensinou. O Turbo Notify não recebe cópia.
  • Um endereço na internet além do Turbo Notify: a conferência de versão lê um único arquivo público de versão no repositório da skill, cerca de uma vez por hora, e tenta de novo depois de 10 minutos se uma checagem falhar. Se continuar falhando, nada para.
  • Os outros servidores MCP que você tiver, só se você autorizar, um por um. Veja Conecte outros MCPs com segurança.

Uma skill que atende estranhos recebe textos escritos por qualquer pessoa. Por isso o atendente virtual separa o que lê do que pode fazer. Com o executor (Claude Code e Codex), a conversa com o cliente roda sem ferramentas e sem acesso aos seus arquivos, e quem envia a resposta é um programa que confere o texto antes. No Claude Desktop, no Cowork e no Antigravity, o que protege é a aprovação de uma pessoa para cada resposta. Os detalhes estão no guia do atendente virtual e, para quem constrói o próprio agente, em Proteja o agente contra injeção de prompt.

O que cada agente consegue

A forma de rodar muda com o agente. Quem precisa de atendimento a qualquer hora usa o Claude Code ou o Codex, que têm o executor: um programa curto que consulta o Turbo Notify e só chama o modelo de IA quando chega mensagem. O Claude Desktop, o Cowork e o Antigravity trabalham com você presente e com aprovação de uma pessoa para cada resposta. A tabela completa está no guia do atendente virtual.