Instalar e gerir skills

Este guia mostra-lhe como encher um espaço de trabalho com skills do GitHub: adicione um repositório como fonte, instale as skills que quiser a partir dele e mantenha-as atualizadas ao longo do tempo.

O que é importante saber antes de começar: um repositório de origem não é de confiança. O nome, a descrição e o número de estrelas dele são escritos por quem é dono do repositório. O único sinal de segurança em que o Control Center confia é o veredicto da análise antivírus, pelo qual passa cada instalação antes de qualquer coisa chegar ao disco ou ao prompt de um agente. Se quiser o raciocínio, leia a secção de skills do modelo de agentes; esta página fica-se pela prática.

As skills ficam em Definições → Espaço de trabalho → Habilidades (/workspaces/<id>/settings/workspace/skills). Têm âmbito de espaço de trabalho: as skills que aqui instalar pertencem apenas a este espaço de trabalho. A página tem dois separadores: Instaladas (skills locais, incluindo um editor Nova competência) e Fontes (catálogos do GitHub). Ambas as gravações passam pelo mesmo portão de análise.

Adicionar um repositório de skills

Abra Definições → Espaço de trabalho → Habilidades e mude para o separador Fontes.
Clique em Adicionar repositório.
Cole o URL de um repositório do GitHub, por exemplo https://github.com/anthropics/skills, e confirme.

O servidor verifica que o repositório existe e está visível com as respetivas credenciais, e depois adiciona-o à barra lateral esquerda. Não há nenhuma loja curada pelo meio: qualquer repositório do GitHub serve, o que também significa que julgar a reputação fica a seu cargo — o número de estrelas é um indício, nunca uma garantia.

As skills de um repositório são os diretórios que contêm um SKILL.md (até três níveis de profundidade, mais o esquema de mercado de plugins do Claude plugins/<plugin>/skills/<skill>, com as árvores de dependências e de código de terceiros ignoradas). Se a grelha disser mais tarde que o repositório não tem skills, é exatamente isso que significa: nenhum diretório nele corresponde à convenção de skills.

Inspecionar uma skill antes de instalar

Selecione um repositório na barra lateral; as skills dele aparecem como uma grelha à direita, com um campo de filtro por cima que restringe o catálogo por nome, descrição ou slug. Clique num cartão para abrir a vista de detalhes. Esta mostra três coisas:

O README, renderizado como markdown — o README.md do diretório da skill, ou o corpo do SKILL.md quando não há README.
A pré-visualização da análise — o veredicto (pass, warn ou quarantine), as capacidades que o conteúdo da skill declara (executa shell, escreve ficheiros, acesso à rede…) e cada constatação que o analisador registou.
A contagem de ficheiros — uma instalação escreve o diretório inteiro da skill, e não apenas o SKILL.md dela.

A pré-visualização analisa exatamente os bytes que uma instalação escreveria, pelo que o veredicto que vê é o veredicto que a instalação recebe; nada é reavaliado à sua revelia.

Instalar uma skill

Abra a vista de detalhes da skill.
Leia o veredicto da análise. Para um veredicto warn ou pass, clique em Instalar.
Para um veredicto quarantine, a instalação mantém-se desativada até assinalar Compreendo o risco — instalar mesmo assim. Essa exceção é registada, não presumida.

A instalação escreve o diretório da skill no espaço de trabalho, regista um pin em skills-lock.json (repositório de origem, caminho, o commit de onde veio e um hash de conteúdo), e a skill passa a estar disponível para os agentes do espaço de trabalho. Um cartão marcado com Nome em uso significa que outra skill já detém esse nome localmente — desinstale primeiro essa.

Atualizar skills ao longo do tempo

Os cartões das skills instaladas ostentam distintivos: Instalada, ou Atualização disponível quando o repositório avançou para além do commit que fixou. Abra a vista de detalhes e clique em Atualizar para voltar a obter a skill no novo commit. Uma atualização passa pelo mesmo portão de análise que uma instalação — uma skill cuja nova versão fica em quarentena é recusada e a versão que tinha permanece no lugar. O hash da versão antiga é guardado como referência de reversão no ficheiro de lock.

Desinstalar uma skill, remover um repositório

Desinstalar (na vista de detalhes de uma skill instalada, ou eliminando no separador Instaladas) remove em conjunto o diretório da skill e o respetivo pin de lock — uma skill desinstalada não deixa nada para trás.

Remover um repositório da barra lateral remove apenas o catálogo: as skills que instalou a partir dele continuam instaladas e continuam a ser atualizadas, porque um pin regista o repositório pelo nome e não por referência à entrada da fonte. Volte a adicionar o repositório se o quiser navegar outra vez.

Invocar uma skill

As skills são invocadas sob o seu próprio espaço de nomes, pelo que nunca colidem com os comandos slash integrados (/plan, /goal, /loop, /compact):

/skill:<name> — uma skill instalada neste espaço de trabalho, ou associada ao agente
/skill:<repo>:<name> — uma skill fornecida por um repo com checkout neste espaço

Um nome simples que não seja integrado continua a ser resolvido, para mensagens escritas antes de o espaço de nomes existir. /skill:plan é o que alcança uma skill chamada plan; /plan é sempre o integrado.

Skills com âmbito de repo

Um repo com checkout pode trazer skills próprias, em .agents/skills/, .agent/skills/, .claude/skills/, .opencode/skills/ ou skills/. Essas não são instaladas através desta página. Um agente transporta apenas as skills do repo em que está a trabalhar no momento; elas são trocadas quando ele muda. O compositor não tem esse âmbito: /skill:<repo>:<name> alcança qualquer repo do espaço.

As skills de repo passam pela mesma análise fail-closed (pass / warn / quarantine) antes de o respetivo frontmatter chegar a um prompt. warn é admitido; quarantine é retido, sem exceção por parte do operador nesse caminho.

Consulte Skills com âmbito de repo e Comandos slash.

Guias relacionados

Conceitos relacionados

O modelo de agentes