Skill da NexTags no Claude Code
Instale a skill da NexTags no Claude Code e monte o seu agente de IA com uma entrevista guiada. Ela entrega os 3 textos para colar no AI Hub.
Uma skill é um pacote de instruções que ensina o Claude a fazer uma tarefa do jeito certo. A skill da NexTags, criar-agente-ia, faz o Claude Code trabalhar como um consultor de agentes: ele entrevista você sobre o negócio, coleta os produtos ou serviços (do site, de um cardápio em PDF, de uma planilha ou de uma lista colada), com as fotos, e entrega 3 textos prontos para colar no AI Hub. Serve para qualquer segmento, como delivery, loja, clínica, salão, imobiliária e serviços. A skill vem no plugin nextags, do catálogo público guiipego/nextags, no GitHub.
Antes de começar
- Uma conta do Claude com acesso ao Claude Code: planos Pro, Max, Team ou Enterprise, ou uma conta do Console. O plano gratuito do Claude não inclui o Claude Code.
- Python 3, para os scripts da skill, que montam o catálogo e conferem os textos. Confira com
python3 --version(no Windows,python --version). Se não tiver, instale pelo site do Python e, no Windows, marque Add python.exe to PATH na instalação. - No Windows, o Git for Windows: o Claude Code usa o Git para baixar o catálogo de plugins.
- Um agente de IA criado no AI Hub, com um provedor de IA conectado. Veja Criar um agente de IA.
Passo a passo
Passo 1: Instale o Claude Code
Se você já usa o Claude Code, pule para o próximo passo. Abra o Terminal (no macOS ou no Linux) ou o PowerShell (no Windows) e cole:
# macOS, Linux e WSL
curl -fsSL https://claude.ai/install.sh | bash
# Windows (PowerShell)
irm https://claude.ai/install.ps1 | iex
Depois, abra um terminal novo e rode claude --version: aparece o número da versão. Digite claude e entre com a sua conta do Claude. Fonte: Advanced setup, da Anthropic.
Passo 3: Instale o plugin
claude plugin install nextags@nextagsA resposta começa com Successfully installed plugin: nextags@nextags. Instalado pelo terminal, o plugin vale para você em todos os projetos do computador. Para conferir, rode claude plugin list: o plugin nextags@nextags aparece com Status: ✔ enabled.
Prefere fazer dentro do Claude Code? Numa sessão aberta, digite /plugin marketplace add guiipego/nextags e depois /plugin install nextags@nextags. O painel abre com os detalhes do plugin: escolha Install for you (user scope). Os comandos estão em Install and manage plugins, da Anthropic.
Passo 4: Abra o Claude Code numa pasta só para o agente
Os 3 textos são salvos como arquivos, então crie uma pasta para eles, como "Agente NexTags", em Documentos, e abra o Claude Code nela:
# macOS e Linux
mkdir -p ~/Documents/"Agente NexTags" && cd ~/Documents/"Agente NexTags" && claude
# Windows (PowerShell)
mkdir "$env:USERPROFILE\Documents\Agente NexTags"; cd "$env:USERPROFILE\Documents\Agente NexTags"; claude
No app do Claude para computador, abra a aba Code e escolha essa pasta. O plugin instalado pelo terminal também aparece no app.
Passo 5: Comece a montar o agente
Na sessão do Claude Code, digite:
/nextags:criar-agente-iaOu peça do seu jeito, como "quero criar meu agente de atendimento na NexTags para a minha confeitaria". A partir daí, a skill conduz o trabalho:
- Pede o nome do negócio e onde estão os produtos ou serviços: site, cardápio, planilha ou lista.
- Faz poucas perguntas por vez. O que você não souber fica marcado
[A DEFINIR], e o agente aprende a dizer que a equipe confirma. - Coleta o catálogo e confere as fotos.
- Escreve os 3 textos, revisa e salva na pasta.
Quando o Claude for ler o seu site ou rodar um script da skill, o Claude Code pede permissão. Escolha Yes; para não ser perguntado de novo pelo mesmo comando, escolha Yes, and don't ask again, quando a opção aparecer.
Passo 6: Cole os 3 textos no AI Hub
No fim, a pasta tem os 3 textos, além dos arquivos de trabalho da skill, como o catálogo:
Agente NexTags/
1_mensagem_do_sistema.md
2_prompt_da_acao.md
3_acoes_de_ia.md| Arquivo | Onde colar na NexTags |
|---|---|
1_mensagem_do_sistema.md | AI Hub › aba Agentes de IA › o seu agente › Mensagem do sistema |
3_acoes_de_ia.md | No mesmo editor, cartão Ações de IA › + Adicionar regra: uma regra para cada regra do arquivo, com o texto do Quando e as ações em O que a IA deve fazer?, na ordem |
2_prompt_da_acao.md | Cartão Ações de IA › ícone de ajustes › Prompt da ação. O ícone aparece quando o agente tem pelo menos uma regra: cole este texto depois das regras. |
Antes de colar as regras, crie o que a skill listar no checklist da entrega: as etiquetas, os campos personalizados (com os nomes exatos do arquivo) e quem recebe as conversas transferidas.
A skill também recomenda a configuração do agente: os formatos em Tipo de resposta da IA, o modelo e os ajustes Max tokens, Reasoning effort e Verbosity. Use o modelo que a skill recomendar, se ele estiver na lista do seu provedor. Onde fica cada ajuste: Modelo, temperatura e limite de tokens. Depois, clique em Salvar, no topo da tela.
Passo 7: Teste antes de ligar para os clientes
Converse com o agente usando um número seu e passe pelos casos que mais dão erro:
Peça o cardápio ou a lista de serviços.
Faça um pedido ou um agendamento completo.
Mude o pedido no meio da conversa.
Pergunte por um produto que não existe.
Peça para falar com uma pessoa.Confira se as transferências, as etiquetas e os campos funcionam. Veja Testar e ajustar o agente e Agente padrão e resposta automática por IA.
Atualizar a skill
Para buscar a versão mais nova do catálogo e atualizar o plugin:
claude plugin marketplace update nextags
claude plugin update nextags@nextagsA versão nova entra na próxima sessão, ou na hora, com /reload-plugins numa sessão aberta. Para atualizar sozinho, digite /plugin dentro do Claude Code, abra a aba Marketplaces, escolha nextags e clique em Enable auto-update: num catálogo de fora da Anthropic, a atualização automática começa desligada.
Pronto: como conferir
claude plugin listmostranextags@nextagscomStatus: ✔ enabled.- Ao digitar
/numa sessão, aparece/nextags:criar-agente-ia. - A pasta do agente tem os 3 arquivos, e o agente no AI Hub está salvo com a mensagem do sistema, as regras e o prompt da ação.
Se não funcionou
O terminal não reconhece o comando claude
Abra um terminal novo depois da instalação. Se continuar, a pasta do Claude Code não está no PATH: siga Troubleshoot installation and login, da Anthropic.
O comando claude plugin não existe
O Claude Code está numa versão antiga. Rode claude update e tente de novo.
A instalação diz que não achou o plugin ou o catálogo
No terminal, a mensagem é Plugin "nextags" not found in marketplace "nextags"; numa sessão, Marketplace "nextags" not found. O catálogo ainda não foi adicionado: rode claude plugin marketplace add guiipego/nextags, escrito exatamente assim, e instale o plugin de novo.
No Windows, apareceu "Command 'git' not found"
Instale o Git for Windows, abra um terminal novo e adicione o catálogo de novo.
A skill não aparece na sessão
Digite /reload-plugins ou abra uma sessão nova com claude. Para ver o que está instalado, digite /plugin e abra a aba Installed.
Apareceu "python3: command not found" ou "python não é reconhecido"
Instale o Python 3 e abra um terminal novo. No Windows, marque Add python.exe to PATH na instalação.
As fotos dos produtos não chegam como imagem no WhatsApp
O WhatsApp aceita imagens em PNG ou JPEG de até 5 MB. Se as fotos do seu site forem WebP, a skill avisa e oferece a conversão para JPG. Veja Tipos de arquivo e limites por canal.
Faça com a IA
Copie o pedido e cole no ChatGPT ou no Claude.
Vou montar o meu agente de IA da NexTags com a skill do Claude Code. Leia este guia: https://docs.nextags.com.br/ia/skill-claude-code.md
Meu sistema: [macOS / Windows / Linux]. Meu negócio: [descreva em uma frase]. Me diga, na ordem, os comandos para instalar o Claude Code e o plugin da NexTags, e o que separar antes de começar a entrevista: o material dos produtos, as fotos e quem recebe as conversas transferidas.
Relacionados
Este conteúdo ajudou?
Obrigado! Sua resposta ajuda a melhorar a central.