Habilitando e Gerenciando Skills em Claude Code, Cowork e Claude.ai

Uma Skill criada uma vez deve funcionar da mesma forma em todos os lugares - as instruções dentro de SKILL.md não mudam dependendo se você está no Claude Code, Cowork ou no aplicativo web claude.ai.

O que difere, de uma superfície para outra, é onde uma Skill reside e como você a ativa.

Esta página aborda a habilitação e organização de Skills em cada uma das três superfícies, e o que verificar quando uma Skill se comporta de maneira diferente em um lugar do que em outro.

Receita

• Identifique quais superfícies você realmente usa no dia a dia - Claude Code para um codebase, Cowork para tarefas de espaço de trabalho em equipe, claude.ai para chat cotidiano - pois cada uma tem sua própria etapa de habilitação.
• No Claude Code, coloque a pasta da Skill na localização de Skills do projeto ou do usuário que a ferramenta espera, para que ela seja reconhecida para aquele repositório ou em todos os seus projetos.
• No Cowork, adicione a Skill à área de Skills do espaço de trabalho da equipe, onde ela se torna disponível para conversas dentro desse espaço de trabalho.
• No claude.ai, adicione a Skill através das configurações de Skills da sua conta, onde ela se torna disponível em suas conversas pessoais.
• Após habilitar em qualquer superfície, teste com uma solicitação real e natural em vez de uma mensagem genérica, e confirme se a saída corresponde ao que as instruções da Skill descrevem.
• Revise periodicamente a lista de cada superfície - desabilitar Skills que você não usa mais mantém a descoberta mais limpa e evita descrições sobrepostas competindo pelas mesmas tarefas.

Exemplo de Trabalho

Habilitar a mesma Skill em todas as três superfícies se parece com isto na prática.

Skill: "code-review-checklist"
Objetivo: disponível no Claude Code (este repositório), Cowork (espaço de trabalho da equipe)
e claude.ai (conta pessoal).
 
1. Claude Code: adicione a pasta da Skill à localização de Skills do projeto
   para que ela se aplique sempre que você estiver trabalhando neste repositório.
2. Cowork: adicione a mesma pasta da Skill à área de Skills do espaço de trabalho da equipe
   para que os colegas de equipe também a recebam, não apenas você.
3. claude.ai: adicione a Skill através das configurações da conta pessoal para que ela esteja
   disponível em chats comuns, fora de qualquer espaço de trabalho ou repositório.
4. Teste cada superfície separadamente: peça uma revisão de código de uma forma que você
   naturalmente a formularia, e confirme se o formato de checklist aparece.

Cada etapa é uma ação de habilitação separada, mesmo que o arquivo SKILL.md subjacente seja idêntico em todas as três - nada do conteúdo da Skill precisa ser reescrito por superfície.

A etapa de teste é mais importante do que parece: uma Skill habilitada corretamente em uma superfície, mas nunca testada lá, pode falhar silenciosamente em ser ativada se a habilitação dessa superfície não foi totalmente bem-sucedida, e a única maneira de capturar isso é com uma solicitação real.

Mergulho Profundo

A razão pela qual a habilitação difere por superfície, enquanto o comportamento uma vez carregado não difere, se resume ao que cada superfície controla.

O Claude Code geralmente é escopado para um projeto ou codebase, então sua localização de Skills está frequentemente ligada a esse projeto, com uma opção para Skills que se aplicam a todos os seus projetos.

O Cowork é construído em torno de espaços de trabalho de equipe compartilhados, então sua área de Skills é naturalmente escopada para um espaço de trabalho - uma Skill adicionada lá se torna disponível para todos que trabalham nesse espaço, não apenas para a pessoa que a adicionou.

O claude.ai é escopado para sua conta pessoal, então as Skills adicionadas lá o seguem em suas próprias conversas, independentemente de qualquer equipe ou repositório.

Nada disso muda como a descoberta funciona depois que uma Skill é habilitada - o Claude ainda verifica o mesmo campo description contra o mesmo tipo de tarefa de entrada, usando a mesma lógica de correspondência, independentemente de em qual superfície a conversa esteja ocorrendo.

O que pode genuinamente diferir entre as superfícies é o acesso a ferramentas: allowed-tools no frontmatter de uma Skill interage com quaisquer ferramentas que essa superfície expõe em primeiro lugar, então uma Skill que referencia uma ferramenta disponível apenas no Claude Code não poderá usá-la dentro da interface de chat do claude.ai, mesmo que a própria Skill esteja habilitada lá.

Gerenciar uma biblioteca crescente de Skills em três superfícies é principalmente uma questão de manter uma versão canônica de cada Skill e decidir deliberadamente onde ela precisa ser habilitada, em vez de deixar cópias ligeiramente diferentes se separarem em superfícies diferentes.

Armadilhas

• Habilitado em uma superfície, testado em outra. Confirmar que uma Skill funciona no claude.ai não garante que ela se comporte da mesma forma no Claude Code se ela nunca foi realmente habilitada lá.
• Skills com escopo de equipe confundidas com pessoais. Uma Skill adicionada a um espaço de trabalho Cowork está disponível para as conversas desse espaço de trabalho, não automaticamente para sua conta pessoal claude.ai.
• Referências a ferramentas que não existem em todas as superfícies. Uma Skill escrita com uma ferramenta específica do Claude Code em mente pode carregar corretamente em outro lugar, mas ser incapaz de usar essa capacidade.
• Cópias desatualizadas se separando. Editar as instruções de uma Skill em uma superfície sem atualizar a mesma Skill em outro lugar leva a um comportamento inconsistente entre as superfícies ao longo do tempo.
• Assumir que reabilitar é necessário após cada edição. A maioria das edições em uma Skill já habilitada em seu SKILL.md entram em vigor ao salvar, sem uma etapa de reabilitação separada - mas vale a pena confirmar em cada superfície em vez de assumir.

Alternativas

• Instruções Personalizadas em vez de uma Skill, quando o objetivo é uma preferência permanente que deve se aplicar a todas as conversas em uma superfície, não uma receita acionada por tarefa.
• O contexto persistente de um Projeto, quando o objetivo são informações vinculadas a um espaço de trabalho em andamento, em vez de uma tarefa repetível que você deseja ter disponível em todos os lugares.
• Manter uma Skill habilitada em apenas uma superfície, quando uma tarefa genuinamente só aparece em um contexto - por exemplo, um fluxo de trabalho específico do Claude Code sem um equivalente em chat comum.

FAQs

Relacionado

• Noções Básicas de Agent Skills - criando sua primeira Skill antes de decidir onde habilitá-la
• Skills vs Projetos vs Instruções Personalizadas: Qual a Diferença - quando uma Skill é a ferramenta certa em vez de um Projeto ou Instruções Personalizadas
• Anatomia de um Arquivo SKILL.md - o campo allowed-tools referenciado no Mergulho Profundo acima
• Sinais de que sua Skill não está sendo descoberta pelo Claude - diagnosticando uma Skill que parece habilitada, mas não está sendo ativada

Versões da Stack: Escrito contra a linha de modelos Claude atual em ~junho de 2026 - Claude Fable 5, Claude Opus 4.8, Claude Sonnet 5 (o padrão) e Claude Haiku 4.5. Nomes de modelos, preços e recursos de produtos mudam rapidamente - verifique os detalhes atuais em platform.claude.com/docs antes de confiar neles.