Skills — visão geral
Uma skill é uma capacidade empacotada que o agente aciona quando ela é relevante: "montar uma apresentação", "ler um PDF", "gerar uma proposta a partir de um modelo da empresa". Esta seção é o guia para autores (quem cria skills) e admins (quem as publica e governa). Para o modelo mental — como o agente decide acionar uma skill — veja Skills (conceito).
Uma skill reúne três coisas em uma pasta: um manifesto (metadados, permissões, segredos que precisa), um prompt (instruções para o agente) e, opcionalmente, scripts (código que faz o trabalho de verdade — por exemplo, gerar um .pptx).
Ciclo de vida
O caminho de uma skill no Imaginne segue sempre as mesmas etapas:
- Origem. A skill nasce de uma das três fontes abaixo (inclusa, da organização ou pessoal).
- Autoria. Você define o manifesto e o prompt — no Skill Studio (web) ou em arquivos locais.
- Publicação. A skill recebe uma versão (semver) e um changelog e entra no catálogo da organização. Veja Publicar e versionar.
- Governança. A skill é atribuída a perfis, que definem quais usuários a recebem. Veja Governança de skills.
- Sincronização. No início de cada sessão, os clientes baixam as skills a que você tem acesso para
~/.imaginne/skills/e removem as que perderam acesso. - Acionamento. Você descreve o que quer; o agente decide se — e qual — skill usar.
De onde vêm as skills
| Origem | O que é | Onde |
|---|---|---|
| Inclusas | Skills de documentos (docx, excel, pdf, ppt_skill) que já vêm com o produto e são instaladas automaticamente. | Embutidas no Desktop e na imagem do chat web. Veja Skills inclusas. |
| Publicadas pela organização | Skills de processo criadas pela sua empresa, atribuídas via perfis. | Catálogo da org, geridas no Skill Studio. |
| Pessoais / do projeto | Skills que você coloca em ~/.imaginne/skills/ ou no .imaginne/skills/ do projeto. | A sua máquina. |
A sincronização da organização gerencia as skills publicadas em ~/.imaginne/skills/. As skills inclusas e as suas skills pessoais coexistem com elas.
Skill ≠ comando ≠ menção de arquivo
Não confunda os três conceitos — eles aparecem de formas diferentes nas superfícies:
| Tipo | Como aparece | O que é |
|---|---|---|
| Skill | o agente aciona quando relevante | Uma capacidade que o modelo usa quando faz sentido. É o assunto desta seção. |
| Comando | /algo | Um comando da interface (host), como /model ou /clear. Não passa pelo modelo. |
| Menção de arquivo | @arquivo | Uma referência a um arquivo do seu workspace — o agente vai lê-lo. As funções são acionadas como skills (pelo modelo), não por um prefixo. |
Você não "roda" uma skill manualmente — você descreve o objetivo e o agente escolhe a ferramenta. A organização controla, via política, quais skills entram na lista apresentada ao modelo.
Modos de execução
Toda skill declara como roda na máquina: local_plain (arquivos abertos, transparentes) ou local_protected (conteúdo verificado, extraído em pasta temporária e removido). Não existe modo "no servidor remoto" — o runtime é sempre local nas superfícies de app. Veja Modos de execução.
Segredos que uma skill precisa
Uma skill que fala com um sistema interno (um CRM, uma API corporativa) declara os segredos de que precisa via required_env. A organização cadastra esses segredos uma vez e o Imaginne injeta apenas os nomes declarados, só naquela execução. Veja Env-secrets (autor) e Env-secrets (admin).
Por onde começar
A estrutura de pasta e os dois esquemas de manifesto, com exemplos reais.
Abrir →Skills inclusasdocx, excel, pdf e ppt_skill — o que cada uma faz.
Abrir →Criar no Skill StudioDo zero ou por conversa, direto no console web.
Abrir →Importar via ZIPO layout exigido, os limites e o passo a passo.
Abrir →Publicar e versionarSemver, changelog, rollback e como os clientes recebem.
Abrir →Modos de execuçãolocal_plain vs local_protected, integridade e quando usar.
Abrir →Env-secrets (autor)Declarar e consumir segredos sem vazamento entre skills.
Abrir →Solução de problemasOs erros mais comuns de skill e como resolvê-los.
Abrir →Próximos passos
Esta página ajudou?
Reportar um problema nesta páginaNão envie senhas, chaves, tokens ou dados de clientes.