Instalar e gerenciar skills

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

O que você precisa saber antes de começar: um repositório de origem não é confiável. 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 veredito da análise antivírus, pelo qual toda instalação passa antes que qualquer coisa chegue ao disco ou ao prompt de um agente. Se você quiser o raciocínio, leia a seção de skills do modelo de agentes; esta página fica na prática.

As skills ficam em Configurações → Espaço de trabalho → Habilidades (/workspaces/<id>/settings/workspace/skills). Elas têm escopo de espaço de trabalho: as skills que você instala aqui pertencem apenas a este espaço de trabalho. A página tem duas abas: Instaladas (skills locais, incluindo um editor Nova competência) e Fontes (catálogos do GitHub). As duas gravações passam pelo mesmo portão de análise.

Adicionar um repositório de skills

1. Abra Configurações → Espaço de trabalho → Habilidades e mude para a aba Fontes.
2. Pressione Adicionar repositório.
3. Cole a 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 credenciais dele, e então o adiciona à barra lateral esquerda. Não há nenhuma loja curada no meio: qualquer repositório do GitHub serve, o que também significa que julgar a reputação é com você — o número de estrelas é indício, nunca 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 layout 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 grade depois disser que o repositório não tem skills, é exatamente isso que significa: nenhum diretório nele segue a convenção de skills.

Inspecionar uma skill antes de instalar

Selecione um repositório na barra lateral; as skills dele aparecem como uma grade à direita, com um campo de filtro acima que restringe o catálogo por nome, descrição ou slug. Clique em um cartão para abrir a tela de detalhes. Ela 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 veredito (pass, warn ou quarantine), as capacidades que o conteúdo da skill declara (executa shell, grava arquivos, acesso à rede…) e cada achado que o analisador registrou.
• A contagem de arquivos — uma instalação grava 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 gravaria, então o veredito que você vê é o veredito que a instalação recebe; nada é reavaliado pelas suas costas.

Instalar uma skill

1. Abra a tela de detalhes da skill.
2. Leia o veredito da análise. Para um veredito warn ou pass, pressione Instalar.
3. Para um veredito quarantine, a instalação continua desativada até você marcar Compreendo o risco — instalar mesmo assim. Essa exceção é registrada, não presumida.

A instalação grava o diretório da skill no espaço de trabalho, registra 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 ficar disponível para os agentes do espaço de trabalho. Um cartão marcado Nome em uso significa que outra skill já é dona desse nome localmente — desinstale essa primeiro.

Atualizar skills ao longo do tempo

Os cartões das skills instaladas trazem selos: Instalada, ou Atualização disponível quando o repositório avançou além do commit que você fixou. Abra a tela de detalhes e pressione Atualizar para buscar de novo 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 você tinha permanece no lugar. O hash da versão antiga é mantido como referência de rollback no arquivo de lock.

Desinstalar uma skill, remover um repositório

Desinstalar (na tela de detalhes de uma skill instalada, ou excluindo na aba Instaladas) remove junto o diretório da skill e seu pin no arquivo 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 você instalou dele continuam instaladas e continuam sendo atualizadas, porque um pin registra o repositório pelo nome, e não por uma referência à entrada de origem. Adicione o repositório de volta se quiser navegar por ele outra vez.

Invocar uma skill

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

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

Um nome puro que não seja integrado ainda é resolvido, para mensagens escritas antes de o namespace existir. /skill:plan é o que alcança uma skill chamada plan; /plan é sempre o comando integrado.

Skills com escopo de repositório

Um repositório com checkout pode trazer skills próprias, em .agents/skills/, .agent/skills/, .claude/skills/, .opencode/skills/ ou skills/. Essas não são instaladas por esta página. Um agente carrega apenas as skills do repositório em que está trabalhando no momento; elas são trocadas quando ele se move. O compositor não tem esse escopo: /skill:<repo>:<name> alcança qualquer repositório do espaço.

As skills de repositório passam pela mesma varredura fail-closed (pass / warn / quarantine) antes que seu frontmatter chegue a um prompt. warn é admitido; quarantine é retido, sem exceção por parte do operador nesse caminho.

Consulte Skills com escopo de repositório e Comandos slash.

Guias relacionados

• Conversar com um agente
• Criar e configurar um agente

Conceitos relacionados

• O modelo de agentes