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.

Use skills para	Não use skills para
Um pedido que você repete (relatório semanal, resposta padrão, triagem)	Uma pergunta única e pontual: fale direto com o Marvin
Garantir que o time faça o mesmo processo do mesmo jeito	Guardar conhecimento e processos escritos: use o Brain
Padronizar o formato de uma resposta recorrente	Fluxos de tela (funil, caixa): isso é dos apps

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 entre Prosa, Tabela, Gráfico e Custom, combinando até dois.
• Compartilhar com pessoas específicas ou com a organização inteira.
• Organizar skills próprias, compartilhadas e mantidas pela Marvee em pastas pessoais, com busca, filtros, ordenação e colunas configuráveis.
• Virar uma entrega agendada, por WhatsApp ou em canal do Chat (veja o caso do resumo que chega sozinho).

Conceitos e acesso

Termo	O que é	Onde aparece
Skill	A receita salva que o Marvin executa quando invocada	Biblioteca de skills, dentro do Marvin
Recipe (instruções)	O passo a passo que a skill segue: o coração dela	Passo Identidade, em Recipe (instructions)
Quando invocar	A descrição que o Marvin lê para decidir, sozinho, se aquela skill serve para o seu pedido	Passo Identidade, em Quando invocar
Comando	O atalho /nome que dispara a skill (gerado do nome, fixo depois de criar)	Gerado do nome, exibido abaixo do título no editor e na biblioteca
Recursos vinculados	Itens do Hub que a skill sempre usa como contexto (até 25)	Passo Identidade, em Recursos vinculados
Formato de saída	Como a resposta sai: Prosa, Tabela, Gráfico ou Custom	Passo Saída
Visibilidade	Quem pode usar a skill: você, um time ou a organização	Passo Acesso
Sandbox	O espaço de teste da skill antes de publicar	Botão Testar, no topo do editor

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. Dá para combinar até dois entre Prosa, Tabela e Gráfico. O Custom, em que você cola um exemplo do formato ideal, é exclusivo e não se combina com nenhum outro.
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:

Campo	Para que serve
Nome	Identifica a skill e gera o comando /
Quando invocar	Faz o Marvin escolher a skill pela intenção do seu pedido
Quando NÃO invocar	Evita que ela seja chamada fora de hora
Recipe (instruções)	O passo a passo que garante o resultado consistente
Próximos passos sugeridos	O que a skill oferece fazer depois de responder
Recursos vinculados	Contexto fixo (Brain, contatos, endpoints do MDC), até 25 itens
Formato de saída	Prosa, Tabela, Gráfico ou Custom, até dois
Quem pode usar	Privada, Time ou Organização
Raciocínio	Quanto o Marvin “pensa” antes de responder (do rápido ao aprofundado)
Status	Ativa ou não (inativa some do autocomplete)

Limites e erros comuns

Expectativa	Realidade hoje
Qualquer pessoa edita a skill compartilhada	Só o criador edita ou apaga; compartilhar dá acesso de uso (ou de coedição, se você conceder)
Dá para trocar o comando depois	O comando (slug) é gerado do nome e fica fixo após criar
Toda skill pode virar entrega agendada	Pode, mas a restrição é do canal: para entrega no WhatsApp, a saída precisa ser Prosa ou Tabela. A própria tela avisa isso na escolha do formato
A skill é um robô isolado com limite próprio	A skill roda dentro da conversa, com as mesmas ferramentas do Marvin; não é um processo separado

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).
• Organize a biblioteca: use pastas pessoais e visualizações salvas para encontrar o conjunto certo em cada rotina.
• Agende uma entrega: transforme a skill num resumo recorrente, por WhatsApp ou em canal do Chat (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.