Pular para o conteúdo principal

Criar uma skill no Skill Studio

O Skill Studio é onde você cria e edita as skills da sua organização, no console web em /app. Esta página cobre os dois caminhos de criação e o editor da skill. Para trazer uma skill pronta empacotada, veja Importar via ZIP; para colocá-la nas mãos dos usuários, veja Publicar e versionar.

Quem pode criar

Criar e editar skills exige o papel de administrador de skills (ou administrador da org) com acesso a pelo menos um grupo de skills. Veja Usuários & papéis e Grupos de skills.

Onde fica​

No console web, abra Skills. O gerador conversacional fica em Skill Studio (rota /org/skill-studio). A partir da lista de skills você tem dois pontos de entrada para criar:

  • Create Skill — formulário rápido que sintetiza um rascunho.
  • Skill Studio — assistente conversacional que descobre o processo com você.

(O terceiro botão, Import from ZIP, é tratado em Importar via ZIP.)

Caminho A — "Create Skill"​

O caminho direto: você informa os metadados e o Studio cria um rascunho com um manifesto sintetizado, pronto para editar.

  1. Clique em Create Skill.
  2. Preencha:
    • Name — vira a Key da skill. Segue o regex ^[a-z0-9][a-z0-9-]{1,98}[a-z0-9]$ (minúsculas, dígitos e hifens; sem acentos ou espaços).
    • Group — o grupo de skills onde a skill nasce. Obrigatório.
    • Category — categoria de catálogo (ex.: docs, sales).
    • Description — o que a skill faz. É o que ajuda o agente a decidir acioná-la, então seja específico.
  3. Confirme. O Studio cria o rascunho e abre o editor, onde você ajusta o prompt, os arquivos e os segredos antes de publicar.

Caminho C — Skill Studio conversacional​

Quando você sabe o processo mas não o manifesto, descreva-o em linguagem natural e o assistente monta a skill com você. O fluxo passa por fases:

FaseO que acontece
discoveryO assistente faz perguntas para entender o processo, as entradas e as saídas.
refiningRefina os passos, os argumentos e as permissões necessárias.
proposalApresenta uma proposta de skill (manifesto + prompt) para você revisar.
generatingGera o conteúdo final da skill.

Ao final, Aprovar e Criar Skill cria a skill e a publica de uma vez. É o caminho da receita Criar uma skill de negócio.

Descreva entradas, saídas e fontes

Quanto mais claro for o processo — "recebe um CSV de leads, gera uma proposta .docx, usa o token do CRM" — melhor o manifesto que o assistente propõe. Mencione explicitamente qualquer segredo (token, chave) que a skill vá precisar.

O editor da skill​

Depois de criar (por qualquer caminho), você cai no editor. Ele tem cinco áreas:

Metadata​

Nome, descrição, categoria, grupo e o modo de execução (radio: normal/protegida — local_plain ou local_protected). Veja Modos de execução para escolher.

Prompt Editor​

O coração da skill. Aqui você escreve o Prompt Content (as instruções que o agente lê — equivale ao SKILL.md) e o Changelog da versão. Um banner de manifesto valida o manifesto enquanto você edita e bloqueia a publicação se ele estiver inválido. Escreva o prompt como nas skills inclusas: diga o que não fabricar, fixe a disciplina de outputs/ e documente o ponto de entrada exato.

Files​

A árvore de arquivos da skill, separada entre o Draft (o que você está editando) e as versões já publicadas. As abas mostram o manifest, o SKILL.md, os scripts e os assets. É aqui que você adiciona o código que faz o trabalho.

Env Secrets​

Onde você declara os segredos de que a skill precisa e os vincula. O Imaginne só injeta um segredo se a skill o declarar. Os valores em si são cadastrados pelo admin da org — veja o lado do autor em Env-secrets e o cadastro em Env-secrets (admin).

Version History​

A linha do tempo das versões publicadas, com rollback: criar uma nova versão a partir de uma antiga. Veja Publicar e versionar para as regras de versionamento. O editor também mostra quais perfis usam a skill.

Do rascunho à publicação​

Criar deixa a skill como rascunho (exceto pelo caminho conversacional, que já publica). Quando estiver pronta:

  1. Garanta que o banner de manifesto está verde (manifesto válido).
  2. Preencha o changelog.
  3. Publique — a skill recebe uma versão e entra no catálogo. Veja Publicar e versionar.

Depois, atribua a skill a um perfil para que os usuários a recebam na próxima sessão.

Veja também​

Importar via ZIP

Trazer uma skill empacotada com scripts.

Abrir →Publicar e versionar

Semver, changelog, rollback e sincronização.

Abrir →Criar uma skill de negócio

A receita completa: descrever → aprovar → atribuir.

Abrir →