Claude Platform Docs
MensagensSkills

Skills para empresas

Governança, revisão de segurança, avaliação e orientação organizacional para implantar Agent Skills em escala empresarial.

Este guia é destinado a administradores e arquitetos corporativos que precisam governar Agent Skills em toda uma organização. Ele aborda como verificar, avaliar, implantar e gerenciar Skills em escala. Para orientações de criação, consulte Melhores práticas de criação de Skills. Para detalhes de arquitetura, consulte Agent Skills.

Revisão de segurança e verificação

Implantar Skills em uma empresa requer responder a duas perguntas distintas:

  1. As Skills são seguras em geral? Consulte a seção considerações de segurança na visão geral para detalhes de segurança em nível de plataforma.
  2. Como verifico uma Skill específica? Use a seguinte avaliação de risco e lista de verificação de revisão.

Avaliação de nível de risco

Avalie cada Skill em relação a estes indicadores de risco antes de aprovar a implantação:

Indicador de riscoO que procurarNível de preocupação
Execução de códigoScripts no diretório da Skill (*.py, *.sh, *.js)Alto: scripts são executados com acesso total ao ambiente
Manipulação de instruçõesDiretivas para ignorar regras de segurança, ocultar ações dos usuários ou alterar o comportamento de Claude condicionalmenteAlto: pode contornar controles de segurança
Referências a servidores MCPInstruções referenciando ferramentas MCP (ServerName:tool_name)Alto: estende o acesso além da própria Skill
Padrões de acesso à redeURLs, endpoints de API, chamadas fetch, curl ou requestsAlto: potencial vetor de exfiltração de dados
Credenciais codificadasChaves de API, tokens ou senhas em arquivos ou scripts da SkillAlto: segredos expostos no histórico do Git e na janela de contexto
Escopo de acesso ao sistema de arquivosCaminhos fora do diretório da Skill, padrões glob amplos, path traversal (../)Médio: pode acessar dados não pretendidos
Chamadas de ferramentasInstruções que direcionam Claude a usar bash, operações de arquivo ou outras ferramentasMédio: revise quais operações são realizadas

Lista de verificação de revisão

Antes de implantar qualquer Skill de terceiros ou de um colaborador interno, complete estas etapas:

  1. Leia todo o conteúdo do diretório da Skill. Revise SKILL.md, todos os arquivos markdown referenciados e quaisquer scripts ou recursos incluídos.
  2. Verifique se o comportamento do script corresponde ao propósito declarado. Execute scripts em um ambiente isolado (sandbox) e confirme que as saídas estão alinhadas com a descrição da Skill.
  3. Verifique instruções adversárias. Procure diretivas que digam a Claude para ignorar regras de segurança, ocultar ações dos usuários, exfiltrar dados por meio de respostas ou alterar o comportamento com base em entradas específicas.
  4. Verifique buscas de URL externas ou chamadas de rede. Pesquise scripts e instruções em busca de padrões de acesso à rede (http, requests.get, urllib, curl, fetch).
  5. Verifique que não há credenciais codificadas. Verifique se há chaves de API, tokens ou senhas em arquivos da Skill. As credenciais devem usar variáveis de ambiente ou armazenamentos seguros de credenciais, nunca aparecer no conteúdo da Skill.
  6. Identifique as ferramentas e os comandos que a Skill instrui Claude a executar. Liste todos os comandos bash, operações de arquivo e referências a ferramentas. Considere o risco combinado quando uma Skill usa ferramentas de leitura de arquivos e de rede em conjunto.
  7. Confirme os destinos de redirecionamento. Se a Skill referenciar URLs externas, verifique se elas apontam para domínios esperados.
  8. Verifique que não há padrões de exfiltração de dados. Procure instruções que leiam dados sensíveis e depois os escrevam, enviem ou codifiquem para transmissão externa, inclusive por meio das respostas conversacionais de Claude.

Verificação de conteúdo de Skills

As organizações do Claude Enterprise podem ativar a verificação de segurança automatizada para Skills personalizadas no claude.ai e no Claude Cowork. A configuração é Verificação de segurança de skills e plugins em claude.ai > Configurações da organização > Skills.

Depois que você ativa a configuração, a verificação se aplica às Skills que os membros enviarem ou editarem a partir de então no claude.ai ou no Cowork. Cada verificação procura sinais de comportamento malicioso. Esses sinais incluem execução de código oculta, transferência dos seus dados para um serviço externo e instruções que adulteram as proteções do Claude.

Se uma Skill pode ser usada depende da sua verificação:

  • Uma Skill que falha na verificação é bloqueada para uso.
  • Uma Skill cuja verificação não foi concluída é bloqueada para uso.
  • Uma Skill que passa com um aviso continua utilizável por trás de um aviso de cautela.

Os proprietários da organização podem permitir algumas Skills que falharam na verificação. O mesmo vale para membros cuja função personalizada pode gerenciar Bibliotecas.

Se a verificação estiver disponível para sua organização, ative-a. A verificação complementa, mas não substitui, a lista de verificação de revisão.

A verificação não cobre a Claude API. As Skills que você carrega por meio da Skills API (/v1/skills), inclusive a partir do Claude Console, não são verificadas, portanto, para implantações via API, confie na lista de verificação de revisão e na fixação de versão. A verificação também não se aplica a Skills que já estavam em sua organização quando você a ativou, ou a organizações com certas configurações de tratamento de dados, como chaves de criptografia gerenciadas pelo cliente (CMEK), retenção zero de dados (ZDR) ou prontidão para HIPAA. Para etapas de configuração, exclusões e tipos de resultado, consulte Comece com a verificação de skills e plugins na Central de Ajuda de Claude.

Avaliando Skills antes da implantação

As Skills podem degradar o desempenho do agente se forem acionadas incorretamente, entrarem em conflito com outras Skills ou fornecerem instruções ruins. Exija avaliação antes de qualquer implantação em produção.

O que avaliar

Estabeleça portões de aprovação para estas dimensões antes de implantar qualquer Skill:

DimensãoO que medeExemplo de falha
Precisão de acionamentoA Skill é ativada para as consultas certas e permanece inativa para as não relacionadas?A Skill é acionada em toda menção a planilha, mesmo quando o usuário só quer discutir dados
Comportamento de isolamentoA Skill funciona corretamente por conta própria?A Skill referencia arquivos que não existem em seu diretório
CoexistênciaAdicionar esta Skill degrada outras Skills?A descrição da nova Skill é muito ampla, roubando acionamentos de Skills existentes
Seguimento de instruçõesClaude segue as instruções da Skill com precisão?Claude pula etapas de validação ou usa bibliotecas erradas
Qualidade da saídaA Skill produz resultados corretos e úteis?Os relatórios gerados têm erros de formatação ou dados ausentes

Requisitos de avaliação

Exija que os autores de Skills enviem conjuntos de avaliação com 3–5 consultas representativas para cada Skill, cobrindo casos em que a Skill deve ser acionada, casos em que não deve ser acionada e casos-limite ambíguos. Exija testes em todos os modelos que sua organização usa (Haiku, Sonnet, Opus), pois a eficácia das Skills varia conforme o modelo.

Para orientações detalhadas sobre como criar avaliações, consulte avaliação e iteração nas melhores práticas de criação de Skills. Para a metodologia geral de avaliação, consulte Definir critérios de sucesso e criar avaliações.

Usando avaliações para decisões de ciclo de vida

Os resultados da avaliação sinalizam quando agir:

  • Precisão de acionamento em declínio: Atualize a descrição ou as instruções da Skill
  • Conflitos de coexistência: Consolide Skills sobrepostas ou restrinja descrições
  • Qualidade de saída consistentemente baixa: Reescreva instruções ou adicione etapas de validação
  • Falhas persistentes entre atualizações: Descontinue a Skill

Gerenciamento do ciclo de vida de Skills

  1. Planejar

    Identifique fluxos de trabalho que sejam repetitivos, propensos a erros ou que exijam conhecimento especializado. Mapeie-os para funções organizacionais e determine quais são candidatos a Skills.

  2. Criar e revisar

    Garanta que o autor da Skill siga as melhores práticas. Exija uma revisão de segurança usando a lista de verificação de revisão. Exija um conjunto de avaliação antes da aprovação. Estabeleça separação de funções: os autores de Skills não devem ser seus próprios revisores.

  3. Testar

    Exija avaliações em isolamento (Skill sozinha) e junto com Skills existentes (teste de coexistência). Verifique a precisão de acionamento, a qualidade da saída e a ausência de regressões em seu conjunto de Skills ativas antes de aprovar para produção.

  4. Implantar

    Faça o upload pela Skills API para acesso em todo o workspace. Consulte Usando Agent Skills com a API para upload e gerenciamento de versões. Documente a Skill no seu registro interno com propósito, responsável e versão.

  5. Monitorar

    Acompanhe padrões de uso e colete feedback dos usuários. Execute novamente as avaliações periodicamente para detectar desvios ou regressões à medida que os fluxos de trabalho e os modelos evoluem. As análises de uso não estão atualmente disponíveis por meio da Skills API. Implemente registro em nível de aplicação para rastrear quais Skills estão incluídas nas solicitações.

  6. Iterar ou descontinuar

    Exija que o conjunto completo de avaliação seja aprovado antes de promover novas versões. Atualize as Skills quando os fluxos de trabalho mudarem ou as pontuações de avaliação diminuírem. Descontinue as Skills quando as avaliações falharem consistentemente ou o fluxo de trabalho for desativado.

Organizando Skills em escala

Limites de recuperação

Como diretriz geral, limite o número de Skills carregadas simultaneamente para manter uma precisão de “recall” (recuperação) confiável. Os metadados de cada Skill (nome e descrição) competem por atenção no prompt do sistema. Com Skills ativas demais, Claude pode não selecionar a Skill certa ou deixar de lado Skills relevantes por completo. Use seu conjunto de avaliação para medir a precisão de recall à medida que adiciona Skills e pare de adicionar quando o desempenho se degradar.

Observe que as requisições de API suportam no máximo 20 Skills por requisição (consulte Usando Agent Skills com a API). Se uma função exigir mais Skills do que uma única requisição suporta, considere consolidar Skills específicas em Skills mais amplas ou encaminhar as requisições para diferentes conjuntos de Skills com base no tipo de tarefa.

Comece específico, consolide depois

Incentive as equipes a começar com Skills restritas e específicas de fluxo de trabalho, em vez de amplas e multipropósito. À medida que os padrões surgem em sua organização, consolide Skills relacionadas em pacotes baseados em função.

Exemplo de progressão:

  • Início: formatting-sales-reports, querying-pipeline-data, updating-crm-records
  • Consolidação: sales-operations (quando as avaliações confirmam desempenho equivalente)

Nomenclatura e catalogação

Use convenções de nomenclatura consistentes em toda a sua organização. A seção convenções de nomenclatura em melhores práticas fornece orientação de formatação.

Mantenha um registro interno para cada Skill com:

  • Propósito: Qual fluxo de trabalho a Skill suporta
  • Proprietário: Equipe ou indivíduo responsável pela manutenção
  • Versão: Versão atualmente implantada
  • Dependências: Servidores MCP, pacotes ou serviços externos necessários
  • Status de avaliação: Data e resultados da última avaliação

Pacotes baseados em função

Agrupe Skills por função organizacional para manter o conjunto de Skills ativas de cada usuário focado:

  • Equipe de vendas: Operações de CRM, relatórios de pipeline, geração de propostas
  • Engenharia: Revisão de código, fluxos de trabalho de implantação, resposta a incidentes
  • Finanças: Geração de relatórios, validação de dados, preparação de auditoria

Cada pacote baseado em função deve conter apenas as Skills relevantes para os fluxos de trabalho diários dessa função.

Distribuição e controle de versão

Controle de origem

Armazene os diretórios de Skills no Git para rastreamento de histórico, revisão de código por meio de pull requests e capacidade de rollback. Cada diretório de Skill (contendo SKILL.md e quaisquer arquivos incluídos) corresponde naturalmente a uma pasta rastreada pelo Git.

Distribuição baseada em API

A Skills API oferece distribuição com escopo de workspace. Skills enviadas pela API ficam disponíveis para todos os membros do workspace. Consulte Usando Agent Skills com a API para endpoints de upload, versionamento e gerenciamento.

Estratégia de versionamento

  • Produção: Fixe as Skills em versões específicas. Se você omitir version, as solicitações usam a versão mais recente, então uma nova versão carregada por qualquer pessoa no workspace altera imediatamente o que os agentes de produção executam. Execute o conjunto completo de avaliação antes de promover uma nova versão. Trate cada atualização como uma nova implantação que requer revisão de segurança completa.
  • Desenvolvimento e teste: Use as versões mais recentes para validar mudanças antes da promoção para produção.
  • Plano de reversão: Mantenha a versão anterior como alternativa. Se uma nova versão falhar nas avaliações em produção, reverta imediatamente para a última versão conhecida como boa.
  • Verificação de integridade: Calcule checksums das Skills revisadas e verifique-os no momento da implantação. Use commits assinados em seu repositório de Skills para garantir a procedência.

Considerações entre superfícies

Mantenha os arquivos de origem das Skills no Git como a única fonte de verdade. Se sua organização implanta Skills em várias superfícies, implemente seu próprio processo de sincronização para mantê-las consistentes. Para detalhes completos, consulte disponibilidade entre superfícies.

Próximos passos

Detalhes de arquitetura e plataforma

Orientação de criação para criadores de Skills

Carregue e gerencie Skills programaticamente

Esta página foi útil?