Skills

Uma skill é um conjunto nomeado de instruções em Markdown que o modelo carrega somente quando precisa delas. Cada skill tem um slug ($docs-style), um nome de exibição, uma breve descrição e as instruções completas.

Carregamento adiado

A descrição é o manifesto: quando as ferramentas estão ativadas em uma interação, a ferramenta integrada load_skill lista o slug, o nome e a descrição de cada skill ativada, e o modelo busca as instruções completas em uma única chamada. Assim, instruções longas nunca ocupam o contexto até serem usadas. Mencionar $slug em uma mensagem incentiva o modelo a carregar essa skill.

Ciclo de vida

As skills podem ser desativadas sem serem excluídas; uma skill desativada sai do manifesto e se recusa a carregar. As atualizações incrementam a versão e arquivam a revisão anterior, e uma reversão restaura qualquer revisão como uma nova versão. O formato de intercâmbio é um documento SKILL.md — frontmatter com nome, slug e descrição, seguido pelas instruções em Markdown literalmente — que é baixado pela exportação e aceito pela importação junto com o envelope JSON. Nomes, descrições e instruções são criptografados em repouso; o slug permanece em texto simples.

Importação de uma loja

As skills podem ser obtidas diretamente de uma fonte remota em Configurações → Skills → De URL. Os formatos aceitos são: um link de listagem do skills.sh, um repositório do GitHub ou URL de tree/blob, uma forma abreviada owner/repo/skill (resolvida de acordo com o layout convencional skills/<name>/SKILL.md) ou um link direto para qualquer arquivo SKILL.md. A busca passa pela mesma proteção de saída fixada usada pelos servidores de ferramentas — somente endereços públicos, com limite de tamanho — e o documento é salvo como uma skill editável sua; assim, uma fonte remota nunca se atualiza silenciosamente.

Arquivos incluídos

Uma skill pode conter arquivos complementares no layout da pasta SKILL.md — documentos de referência, modelos e código-fonte de scripts indicado pelas instruções. load_skill lista o pacote ao final das instruções, e o modelo lê um arquivo sob demanda com a ferramenta read_skill_file, para que uma referência grande nunca ocupe contexto até que seja realmente necessária.

Os arquivos acompanham a skill em todos os lugares: Configurações → Skills → De pasta envia uma pasta local de SKILL.md em uma etapa, uma importação remota obtém os arquivos de texto ao lado do SKILL.md buscado, a exportação JSON inclui o pacote e o modal de edição gerencia os arquivos um por um. Os caminhos são relativos e nunca podem sair da skill; o conteúdo é somente texto, criptografado em repouso e limitado (32 arquivos, 200 KB cada, 1 MB por skill).

Skills ensinadas

As skills cujo slug começa com taught- foram criadas por meio da demonstração de uma tarefa na tela de um Work Computer: a gravação é compilada deterministicamente em um manual em linguagem natural — com alvos de clique ancorados, segredos ocultados e um escopo permitido derivado dos sites visitados pela demonstração — e salva como uma skill comum, recebendo versionamento, edição e compartilhamento como qualquer outra. As execuções do Work com computador ativado carregam automaticamente as skills ensinadas e ativadas pelo proprietário. Depois que uma execução termina, uma avaliação com um clique de funcionou/falhou nos chips de skills da execução acrescenta uma linha datada à seção Histórico da skill; cada avaliação é uma versão normal da skill, de modo que o histórico pode ser editado e restaurado aqui como qualquer outra alteração.

Compartilhamento e perfis

As skills são privadas por padrão e podem ser compartilhadas pelo modelo comum de concessão de recursos. Um perfil de assistente pode vincular um subconjunto de skills, e as sessões que usam esse perfil veem somente essas skills no manifesto.

Exemplo

Crie uma skill em Configurações → Skills (ou escolha um dos modelos iniciais disponíveis e edite-o):

• Slug: cite-sources

• Nome: Cite sources

• Descrição: How to cite evidence: numbered references with URLs, no unreferenced claims. (esta linha é o que o modelo vê no manifesto — faça com que ela indique quando usar a skill)

• Instruções:

  # Citing sources
  
  - Every factual claim gets a numbered reference like [1].
  - End with a References section: number, title, URL.
  - If no source exists, say so instead of inventing one.

Ative as ferramentas no campo de composição e peça:

Summarize the latest results and $cite-sources.

Digitar $ completa automaticamente os slugs das suas skills. O modelo vê cite-sources em seu manifesto, chama load_skill para buscar as instruções acima e formata a resposta de acordo com elas. Desative a skill em seu cartão para que ela desapareça do manifesto sem ser excluída.