A skill criar-plugin-novus orienta um agente de IA a criar ou adaptar plugins do Novus CRM. Ela reúne as regras do protocolo, das superfícies, do manifesto e das chamadas de API pelo proxy. Também explica como obter o usuário logado e o atendimento em foco. O código de referência está no repositório de exemplo. Uma skill é um arquivo de instruções para o agente. Ela não é o plugin que você publica no Novus CRM. O arquivo SKILL.md não deve entrar no pacote do plugin.

​
Obtenha a skill

1

Baixe o repositório de exemplo

Clone o repositório ou baixe os arquivos pelo GitHub.
2

Localize o arquivo

A skill está em .agents/skills/criar-plugin-novus/SKILL.md. Leia o arquivo antes de instalá-lo.

​
Codex, Claude Code e Gemini CLI

Esses agentes podem carregar a skill a partir de uma pasta do projeto. Ao trabalhar dentro do repositório de exemplo, Codex e Gemini CLI encontram .agents/skills. Claude Code encontra o mesmo arquivo pelo link em .claude/skills. Para ter a skill em todos os seus projetos, copie a pasta inteira para o diretório da ferramenta:
1

Crie o diretório pessoal

Escolha o caminho da sua ferramenta na tabela. Por exemplo, para Codex:
Para Claude Code ou Gemini CLI, troque ~/.agents/skills pelo diretório da tabela.
2

Abra uma conversa

Peça ao agente para criar ou adaptar um plugin do Novus CRM. Informe onde a ação deve aparecer e quais dados ela usa.

​
ChatGPT, Claude e Gemini no navegador

Cada aplicativo tem sua própria tela para guardar instruções. Use o arquivo da skill, sem incluir os arquivos do plugin de exemplo.
1

ChatGPT

Gere um ZIP com a pasta da skill:
Abra Plugins > Skills > Create > Upload from your computer e envie criar-plugin-novus.zip. Veja o guia do ChatGPT.
2

Claude

Gere um ZIP que contenha a pasta criar-plugin-novus/ com SKILL.md dentro dela:
Abra Customize > Skills > Create skill > Upload a skill e envie criar-plugin-novus.zip. Veja o guia do Claude.
3

Gemini Spark

Abra Switch to Spark > Skills > Upload em gemini.google.com. Selecione SKILL.md, revise as instruções e clique em Create. Veja o guia do Gemini.

​
OpenRouter e outros modelos

O OpenRouter encaminha mensagens ao modelo escolhido. A aplicação que faz a chamada precisa carregar o texto de SKILL.md como instrução de sistema ou de desenvolvedor. Depois, envie o pedido do plugin como mensagem do usuário. A API de chat do OpenRouter aceita esse formato:
Em outro aplicativo sem instalação de skills, anexe SKILL.md ou cole seu conteúdo no início da conversa. Peça ao modelo que siga as instruções do arquivo. Se o aplicativo não puder editar arquivos, peça os arquivos completos do plugin e salve-os no seu projeto.

​
Confira o resultado

O agente deve entregar os arquivos do plugin, o manifesto e, quando houver, as variáveis que você precisa cadastrar. Confira se as superfícies e os hosts usados no código aparecem nas permissões. Siga Publicar um plugin para enviar o pacote. Uma verificação de sintaxe não testa a integração com as APIs. Confira os dados com o plugin carregado no Novus CRM, depois de configurar as variáveis da conta. O protocolo de plugins descreve os comandos e os eventos disponíveis.