Skills: transforme o que se repete em um comando

Toda semana a mesma coisa: você reescreve para o Marvin aquele pedido longo (“puxe os negócios ganhos do mês, agrupe por vendedor, no formato de tabela…”), e o resultado sai um pouco diferente a cada vez. Skills resolvem isso: você empacota o pedido uma vez e ele passa a rodar do mesmo jeito, sempre. É o que torna uma necessidade repetida determinística e consistente.

O que é e quando usar

Uma skill é uma receita salva para o Marvin: você escreve uma vez o que ele deve fazer (o passo a passo, o formato da resposta, os dados que sempre entram) e depois invoca por um comando (/nome) ou pedindo em linguagem natural. Quando roda, a skill tem acesso às mesmas ferramentas do Marvin (consultar o Brain, ler o CRM, executar um endpoint do MDC), só que guiada pela sua receita, com resultado previsível.

O que as skills entregam hoje:

• Criar uma skill num editor guiado (identidade, saída, acesso e agendamento).
• Testar no sandbox antes de publicar, contra as suas ferramentas reais.
• Invocar por comando (/nome-da-skill) ou por linguagem natural.
• Fixar recursos vinculados (páginas do Brain, contatos, empresas, endpoints do MDC) que entram no contexto toda vez.
• Escolher o formato de saída (texto, tabela ou gráfico).
• Compartilhar com pessoas específicas ou com a organização inteira.
• Virar uma entrega agendada por WhatsApp (veja o caso do resumo que chega sozinho).

Conceitos e acesso

Acesso. O editor de skills fica disponível dentro do Marvin (e no menu de skills presente nos apps). Criar skills exige a permissão de criar skills; compartilhar com o time ou com a organização e agendar entregas são permissões à parte, que o administrador concede (veja Membros e permissões).

Primeiro uso: passo a passo

1. Abra a biblioteca de skills e clique em Nova skill. Você entra num editor de quatro passos.
2. Identidade. Dê um nome (o comando / é gerado dele), escreva Quando invocar (o que faz o Marvin escolher esta skill), opcionalmente Quando NÃO invocar, e a Recipe: o passo a passo do que a skill deve fazer.
3. Saída. Escolha o formato da resposta (texto, tabela ou gráfico). Se precisar de um layout específico, cole um exemplo do formato ideal.
4. Acesso. Defina quem pode usar (Privada, Time ou Organização) e deixe a skill Ativa.
5. Teste no sandbox. Clique em Testar, faça uma pergunta de teste e veja a skill rodar contra as suas ferramentas reais, com as chamadas e o resultado. Ajuste a receita até ficar redonda.
6. Salve e invoque. Clique em Criar skill. A partir daí, use por /comando ou peça em linguagem natural.

Checklist do primeiro uso: criar uma skill com nome, “quando invocar” e a receita, testar no sandbox, salvar e invocar por comando.

Anatomia de uma skill

Os campos que você preenche no editor, e para que servem:

Limites e erros comuns

Erros comuns de quem começa: escrever uma receita vaga (quanto mais específico o passo a passo, mais consistente o resultado), não preencher o “Quando invocar” (sem isso o Marvin não sabe quando usar a skill em linguagem natural) e publicar sem testar no sandbox (o teste é o que separa a skill que funciona da que quase funciona).

Próximo passo

• Compartilhe com o time: publique a skill para a organização e todo mundo passa a fazer o processo do mesmo jeito (veja o caso de padronizar um processo).
• Agende uma entrega: transforme a skill num resumo recorrente por WhatsApp (veja o caso do resumo que chega sozinho).
• Marvin: a skill roda com todo o poder do Marvin; entender o assistente ajuda a escrever receitas melhores.