Busque em todas as páginas da documentação
Antes que uma nova Skill seja enviada, vale a pena revisar um pequeno conjunto de verificações que capturam a maioria dos problemas que, de outra forma, surgiriam mais tarde, quando a Skill já estiver em uso.
Cada regra abaixo é a forma positiva de um erro abordado em outra parte desta seção - declarada aqui como o que fazer, não apenas o que evitar.
allowed-tools para a menor lista que as instruções realmente exigem. Isso se mantém mesmo que a Skill seja posteriormente acionada por uma tarefa que seu autor não antecipou completamente.allowed-tools e a descrição juntos após qualquer edição de instrução que adicione um novo tipo de etapa. O escopo e as condições de acionamento tendem a se dessincronizar com instruções que foram editadas fragmentadamente.Adicionar uma cláusula explícita "Use quando..." à descrição. A falta de linguagem de acionamento é a razão mais comum pela qual uma Skill não é descoberta, mesmo que suas instruções estejam corretas.
Execute uma tarefa que você esperaria que acionasse a Skill e uma que você esperaria que não acionasse, e confirme se o Claude toma a decisão correta em ambas.
allowed-tools é uma restrição sobre a Skill como um pacote, independente do que as instruções de qualquer etapa individual dizem para fazer - ele se mantém mesmo que as instruções não antecipem totalmente uma situação, é por isso que pertence ao empacotamento em vez da lógica passo a passo em si.Não. Agrupar especulativamente adiciona um arquivo para manter sem uma necessidade comprovada - espere até que uma etapa de instrução genuinamente o exija.
Cada item aqui é a forma positiva e preventiva de um erro abordado em Erros Comuns que Tornam uma Skill Difícil para o Claude Encontrar ou Usar - esta página destina-se a ser executada antes do envio, aquela destina-se a diagnosticar um problema existente.
O nome não afeta o acionamento diretamente, mas um nome incompatível ou vago torna uma biblioteca de Skills crescente muito mais difícil de escanear, e torna mais difícil identificar Skills quase duplicadas antes que sejam construídas duas vezes.
allowed-tools - o mergulho profundo por trás do item allowed-tools no grupo C.Versões do 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 do produto mudam rapidamente - verifique os detalhes atuais em platform.claude.com/docs antes de confiar neles.
Revisado por Chris St. John·Última atualização: 16 de jul. de 2026