Pular para o conteúdo principal

Skills (governança)

A página Skills (/org/skills) é o catálogo de skills da sua organização. É daqui que você cria ou importa skills, controla como elas executam, gerencia versões e as disponibiliza (via perfis) para as pessoas. Esta página cobre a governança no console; para a autoria a fundo (estrutura do manifesto, exemplos, modos de execução em detalhe), veja a seção Skills.

A listagem mostra as skills da organização com nome, grupo, status e versão. Você pode filtrar por:

  • Grupo — restringe ao grupo de skills escolhido.
  • Status — por exemplo, rascunho/publicada/arquivada.
  • Categoria — a categoria declarada na skill.

Duas ações iniciam uma skill nova:

  • Create Skill — cria uma skill do zero (inclui o gerador conversacional, o Skill Studio).
  • Import from ZIP — importa um pacote pronto (manifest.yaml + prompt.md + scripts).
A autoria tem página própria

Os três caminhos de criação (formulário, importação por ZIP e Skill Studio conversacional) estão detalhados em Criar uma skill e Importar uma skill. Aqui o foco é a governança do catálogo.

Detalhe e editor da skill​

Abrir uma skill leva ao editor, dividido em abas/cartões:

Metadata​

Contém os metadados e o seletor de modo de execução:

ModoComportamento
Normal (local_plain)Os arquivos da skill ficam abertos em ~/.imaginne/skills/<key>/. Transparente.
Protegida (local_protected)No disco fica só um resumo; o conteúdo chega em um bundle verificado, extraído em pasta temporária e removido após a execução.

Veja Modos de execução e Skills protegidas para o que cada modo garante (e o que não garante — não é DRM/criptografia).

Prompt Editor​

Edita o conteúdo do prompt da skill, com:

  • Changelog — obrigatório ao publicar uma nova versão; descreve o que mudou.
  • Banner de manifesto — valida o manifesto e bloqueia a publicação enquanto houver erro, mostrando o que corrigir.

Files​

Mostra os arquivos da skill, separando o rascunho (draft) das versões publicadas, com abas para manifest, SKILL.md, scripts e assets.

Env Secrets​

Lista e gerencia os env-secrets que a skill usa. O Imaginne só injeta um segredo se a skill o declarar em required_env (ou env.secrets).

Version History​

Histórico de versões publicadas, com rollback: criar uma nova versão a partir de uma antiga.

Profiles usando​

Mostra quais perfis incluem esta skill — útil para entender o alcance antes de mudar ou arquivar.

Publicar e versionar​

  • A versão é o campo version do manifesto (string semver).
  • Publicar a mesma versão com conteúdo idêntico é um no-op; mesma versão com conteúdo diferente é recusado (faça bump da versão).
  • Publicar deprecia a versão atual e promove a nova; o rollback cria uma nova versão a partir de uma anterior.
  • Após publicar, a política é invalidada: o próximo request rebusca, e os clientes sincronizam as skills no início da sessão.
Detalhes do fluxo de publicação

As regras completas (idempotência, conflito 422, depreciação, sincronização) estão em Publicar uma skill.

Arquivar​

Archive remove a skill do alcance dos usuários (ela sai das sessões na próxima sincronização). É a forma de aposentar uma skill sem apagar o histórico de versões.

Veja também​

Skills — visão geral

O ciclo de vida e o modelo de skills.

Abrir →Criar uma skill

Formulário, Skill Studio e importação.

Abrir →Grupos de skills

Onde toda skill é organizada e delegada.

Abrir →Env-secrets

Segredos que as skills declaram e o Imaginne injeta.

Abrir →