Skills para agentes de IA

Skills GetMyBot são wrappers de agente prontos sobre a GetMyBot API. Elas ensinam um agente de IA (por exemplo, Claude Code) a trabalhar com seus bots em linguagem natural: "crie uma reação no GetMyBot", "inicie uma transmissão GetMyBot por marcação VIP", "mostre as estatísticas do bot". Por baixo dos panos, a skill chama as ferramentas MCP do GetMyBot, e se o servidor MCP não estiver conectado — faz as mesmas requisições via REST com seu token.

Skills não são uma funcionalidade paga separada nem um marketplace. São arquivos SKILL.md (formato Claude Code) que você instala localmente junto com seu agente.

Como funciona

Cada skill é construída com o princípio de revelação progressiva: uma descrição curta aciona a skill em formulações do domínio, e a referência pesada de API é carregada somente quando necessário. Dentro de cada skill estão documentados dois caminhos de acesso:

  • MCP (preferencial) — se o servidor MCP GetMyBot estiver conectado ao agente, a skill chama as ferramentas diretamente.
  • REST-fallback — se MCP não estiver disponível, a skill executa as mesmas operações com requisições curl com token pessoal.

A autenticação em todas as skills é a mesma: token pessoal mbp_… e endereço base /api. Mais detalhes no guia de autenticação.

Seis skills

  • mybot — ponto de entrada e navegação: o que é GetMyBot API, como obter PAT e seus escopos, endereço base, como conectar o servidor MCP, quando usar REST e quando MCP, formato de erros, paginação e limites. Daqui o agente acessa as outras cinco skills.
  • mybot-bots — conexão e gerenciamento de bots: verificação de token, conexão, lista e cartão, atualização, sincronização, troca de token, transferência, exclusão, configurações, templates.
  • mybot-reactions — construtor de reações (o maior): estrutura "gatilho → condições → chats → ações", criação e atualização, tipos de gatilhos, condições E/OU, catálogo de ações, mensagens e botões, botões dinâmicos e parâmetros, fórmulas (DSL), pastas, vínculos de reações, importação do SamBot, verificação de fórmulas, ordem.
  • mybot-broadcasts — transmissões: início por reação, segmentação por marcações, pausa/retomada/cancelamento e status, edição de mensagens já enviadas (individual e "para todos"), fila e retentativas.
  • mybot-data — dados e integrações: coleções (tabelas — campos e registros), cenários (flows), integrações (IA, Google Sheets, GetCourse, handler externo via WebSocket), conexões e acessos.
  • mybot-analytics — observabilidade e audiência: estatísticas (consumo de saldo, métricas, journal, saúde das reações), análises (audiência, chats, funis), assinantes e marcações, diálogos, faturamento (saldo, planos, transações).

Instalação

As skills ficam no repositório GetMyBot na pasta skills/. Cada skill é uma pasta skills/<name>/ com os arquivos SKILL.md (guia resumido) e reference.md (referência completa do domínio com exemplos em MCP e curl).

Para que o agente veja as skills, vincule-as ao seu diretório de skills do Claude Code. No repositório há um script pronto:

./skills/install.sh

Ele cria symlinks ~/.claude/skills/<name> para as pastas dentro do repositório — alterações no repositório ficam imediatamente visíveis ao agente, sem cópias desnecessárias. Após a instalação, formule a tarefa em palavras comuns ("monte no GetMyBot um bot de resposta automática"), e o agente buscará a skill necessária.

Próximos passos