Aviso: Não há documentação legada disponível para este item, portanto, você está vendo a documentação atual.
PushEngage Agent Skills é um plugin que ensina agentes de codificação de IA a integrar e depurar o SDK do PushEngage em seu aplicativo móvel. A versão 1.0.0 é o primeiro lançamento, e as skills seguem dois padrões abertos, o padrão Agent Skills (SKILL.md) e o formato Agent Plugins, para que funcionem com qualquer agente que suporte um deles, incluindo Claude Code, Cowork, Cursor, Codex, Copilot, Windsurf e VS Code. Este guia explica o que ele inclui e como instalá-lo.
Antes de Começar
- Você precisa de uma conta PushEngage com um aplicativo configurado no painel.
- Você precisa de um agente de codificação de IA que suporte Agent Skills ou Agent Plugins. Claude Code é recomendado.
- Para as ferramentas de conta, o plugin usa Node.js 18 ou posterior para executar o servidor MCP empacotado através de
npx.
O que o PushEngage Agent Skills Faz
O plugin fornece ao seu agente conhecimento passo a passo do SDK do PushEngage para que ele possa configurar e solucionar problemas de notificações push sem que você precise procurar na documentação.
- Fluxos completos de integração de SDK para iOS, Android, Flutter e React Native.
- Uma skill de diagnóstico que audita uma integração quebrada, compara sua versão do SDK com uma tabela de problemas conhecidos com versão fixada e percorre uma árvore de decisão de sintomas quando a auditoria não encontra nada.
- O servidor MCP do PushEngage empacotado dentro do plugin, para que seu agente também possa operar sua conta, como enviar e agendar notificações, construir segmentos e ler análises.
O plugin envia seis skills que trabalham juntas.
| Skill | Propósito |
|---|---|
pushengage | Skill de entrada. Detecta sua plataforma e roteia para a correta. |
pushengage-ios | Integração e depuração de iOS. |
pushengage-android | Integração e depuração de Android. |
pushengage-flutter | Integração e depuração de Flutter. |
pushengage-react-native | Integração e depuração de React Native. |
pushengage-debug | Skill de diagnóstico compartilhado para integrações quebradas. |
Como as Skills Funcionam
Cada skill é ativada automaticamente com base no projeto que detecta. A skill de entrada identifica sua plataforma e a transfere para a skill de integração correspondente. Quando algo está quebrado, a skill de diagnóstico é executada em três estágios: primeiro uma auditoria estática da sua configuração, depois uma comparação com problemas conhecidos para sua versão do SDK e, finalmente, uma árvore de decisão orientada por sintomas. Se ainda assim não conseguir resolver o problema, ela empacota um bundle de suporte que você pode enviar para a equipe do PushEngage.
Instalar no Claude Code ou Cowork
Adicione o marketplace de plugins e instale o plugin.
/plugin marketplace add awesomemotive/pushengage-skills
/plugin install pushengage
A instalação do plugin também configura o servidor oficial MCP do PushEngage (@pushengage/mcp). Na primeira vez que seu agente usar uma ferramenta de conta, ele abrirá uma janela do navegador para fazer login na sua conta PushEngage. Até que você faça login, as ferramentas de conta permanecerão inativas.
Instalar em Outros Agentes
Para Cursor, Codex, Copilot, Windsurf e outros agentes compatíveis com SKILL.md, use a CLI de skills.
npx skills add awesomemotive/pushengage-skills
Instalar em Clientes de Plugins de Agente
O repositório também está em conformidade com o formato aberto de Plugins de Agente, com um manifesto plugin.json, um diretório skills/ e um mcp.json. Qualquer cliente que suporte Plugins de Agente pode carregá-lo como um plugin. Clientes compatíveis atualmente incluem VS Code, Cursor, GitHub Copilot, ChatGPT e Codex, Kiro, Hermes Agent, OpenClaw, Grok Bot e NanoClaw. Use o mecanismo de instalação de plugins do seu cliente e aponte-o para o repositório awesomemotive/pushengage-skills. Clientes que suportam o mcp.json do plugin também obtêm o servidor MCP oficial configurado automaticamente.
Instalar Manualmente
As skills ficam no diretório skills/ no repositório awesomemotive/pushengage-skills. Copie as pastas de skill para o diretório de skills do seu agente ou aponte seu agente para o repositório. Cada skill é ativada automaticamente com base no tipo de projeto que detecta.
Usando as Skills
Após a instalação, converse com seu agente em linguagem natural. Por exemplo:
- “Ajude-me a integrar o PushEngage neste aplicativo.” Isso executa o fluxo completo de integração.
- “As notificações do PushEngage não estão chegando no meu iPhone.” Isso executa o fluxo de diagnóstico.
- “Audite minha configuração do PushEngage.” Isso executa a auditoria estática.
O plugin detecta sua plataforma automaticamente e transfere para a skill de integração ou depuração correspondente. Com o servidor MCP conectado, você também pode operar sua conta, por exemplo, “Envie uma notificação com o título ‘Promoção termina hoje à noite’ para o meu segmento dos EUA” ou “Como foi o desempenho da campanha da semana passada?”
Se preferir seguir as etapas de integração você mesmo, consulte a documentação do SDK Mobile PushEngage.
Perguntas Frequentes
Com quais agentes isso funciona?
As skills seguem o padrão Agent Skills (SKILL.md) e o formato Agent Plugins, portanto, funcionam com qualquer agente que suporte um deles, incluindo Claude Code, Cowork, Cursor, Codex, Copilot, Windsurf e VS Code. Claude Code e Cowork o instalam como um plugin, outros agentes SKILL.md o adicionam através da CLI de skills, e clientes Agent Plugins o carregam através de seu próprio mecanismo de instalação de plugins.
Quais plataformas são suportadas?
O plugin inclui fluxos de integração e depuração para iOS, Android, Flutter e React Native. A skill de entrada detecta sua plataforma automaticamente e transfere para a skill correspondente.
Preciso configurar algo para as ferramentas de conta?
Você precisa do Node.js 18 ou posterior, pois o servidor MCP incluído é executado através do npx. Na primeira vez que seu agente usar uma ferramenta de conta, ele abrirá uma janela do navegador para você fazer login no PushEngage. Até então, as ferramentas de conta permanecem inativas e as skills de integração e depuração continuam funcionando.
O que a skill de diagnóstico verifica?
Ela executa uma auditoria estática da sua integração, compara a versão do seu SDK com uma lista de problemas conhecidos com versão fixada e percorre uma árvore de decisão de sintomas. Se não conseguir encontrar a causa, ela prepara um pacote de suporte para a equipe do PushEngage.
É gratuito para usar?
O plugin é lançado sob a licença MIT. Você ainda precisa de uma conta PushEngage com um aplicativo configurado para usá-lo.
Recursos
- PushEngage Agent Skills no GitHub: awesomemotive/pushengage-skills
- PushEngage MCP server no GitHub: awesomemotive/pushengage-mcp
- O pacote do servidor MCP no npm:
@pushengage/mcp
Se você encontrar algum problema, sinta-se à vontade para entrar em contato conosco clicando aqui. Nossa equipe de suporte poderá ajudá-lo.
