Skills (conceito)
Uma skill é uma unidade de capacidade que o agente usa quando relevante. Pense nela como uma competência documentada — "montar uma apresentação", "ler um PDF", "gerar uma planilha" — que o modelo sabe acionar.
Esta página é o conceito. Para criar, testar e publicar skills, veja a seção Skills.
Skill ≠ comando ≠ menção de arquivo
O Imaginne distingue três coisas:
| Tipo | Como aparece | O que é |
|---|---|---|
| Skill | o agente aciona quando relevante | Uma capacidade que o modelo usa quando faz sentido. |
| Comando | /algo | Um comando da interface (host), como /model ou /clear. |
| Menção de arquivo | @arquivo | Uma referência a um arquivo do seu workspace — o agente vai lê-lo. |
@ é para arquivos, não é uma "função"O @ aponta um arquivo do workspace (como nos editores de IA). Já as funções são acionadas como as skills — pelo modelo, quando fazem sentido —, não por um prefixo que você digita.
De onde vêm as skills
- Inclusas (sempre disponíveis). As skills de documentos —
docx,excel,pdf,ppt_skill— vêm embutidas e são instaladas automaticamente. Veja Skills inclusas. - Publicadas pela organização. Criadas no Skill Studio e sincronizadas para os clientes conforme a sua política.
- Pessoais / do projeto. Skills que você coloca em
~/.imaginne/skills/ou no.imaginne/skills/do projeto.
Como o agente aciona uma skill
Você não "roda" uma skill manualmente — você descreve o que quer e o agente decide se e qual skill usar. As skills disponíveis são apresentadas ao modelo como capacidades; quando uma é relevante, ele a aciona. A organização controla, via política, quais skills entram nessa lista para você.
Execução local — normal vs protegida
Skills rodam na sua máquina (nas superfícies locais). Há dois modos:
| Modo | O que significa |
|---|---|
| Local normal | Os arquivos da skill ficam abertos em ~/.imaginne/skills/. Transparente e fácil de inspecionar. |
| Local protegida | No disco fica só um resumo; o conteúdo vem em um bundle verificado (assinatura + digest), extraído em pasta temporária, executado e removido. Protege contra inspeção casual e redistribuição — mas não é DRM. |
Detalhes em Modos de execução e Skills protegidas.
Segredos que uma skill precisa
Uma skill pode declarar required_env — os nomes dos segredos de que ela precisa (tokens de API de um sistema interno, por exemplo). A organização cadastra esses segredos e o Engine injeta apenas os nomes declarados, só naquela execução. Veja Env-secrets.
Veja também
Esta página ajudou?
Reportar um problema nesta páginaNão envie senhas, chaves, tokens ou dados de clientes.