Este artigo explica como proprietários de organizações podem provisionar skills para todos os usuários em sua organização. Provisionar skills para sua equipe permite que você distribua fluxos de trabalho e capacidades aprovados em toda a sua organização a partir de um local centralizado.
O gerenciamento de skills em toda a organização está disponível para planos Team e Enterprise.
Pré-requisitos
Antes de provisionar skills para sua organização, você deve ativar duas capacidades alternando-as:
Execução de código e criação de arquivos em Configurações da organização > Capacidades
Skills em Configurações da organização > Skills
Skills requerem execução de código para funcionar, portanto, se a execução de código estiver desativada, skills não estarão disponíveis.
Provisionar skills para sua organização
Quando você carrega uma skill através das configurações da organização, ela fica automaticamente disponível para todos os usuários em sua organização em Personalizar > Skills. Isso significa que usuários individuais não precisam mais fazer upload manual das mesmas skills.
Para provisionar uma skill:
Navegue até Configurações da organização > Skills.
Na seção Skills da organização, clique em "+ Adicionar."
Selecione um arquivo .zip contendo sua skill (deve incluir um arquivo SKILL.md).
A skill é imediatamente provisionada para todos os usuários em sua organização.
Skills provisionadas por administrador são ativadas por padrão para todos em sua organização, mas os usuários ainda podem desativar skills individuais se desejarem. Isso oferece às organizações fluxos de trabalho consistentes e aprovados entre equipes, enquanto permite que usuários individuais personalizem sua experiência.
Controlar o compartilhamento de skills entre membros
Além de provisionar skills de cima para baixo, você pode permitir que membros compartilhem skills que criaram uns com os outros. Dois alternadores independentes controlam isso:
Compartilhamento de skill: Membros podem compartilhar uma skill com colegas específicos. Os destinatários veem a skill na seção Compartilhado com você de sua lista de skills.
Compartilhar com a organização: Membros podem publicar uma skill no diretório da organização, onde qualquer pessoa pode encontrá-la e instalá-la.
Ambos os alternadores estão desativados por padrão. Você pode ativar um ou ambos em Configurações da organização > Skills.
Nota: Skills compartilhadas são somente leitura. Os destinatários podem ativar e usar uma skill compartilhada, mas não podem editar seu conteúdo. Compartilhamento em grupo e permissões de edição estão planejados para uma versão futura.
Como skills compartilhadas diferem de skills provisionadas
| Provisionada pelo proprietário | Compartilhada ponto a ponto | Compartilhada em toda a organização |
Quem pode compartilhar | Apenas proprietários | Qualquer membro (se ativado) | Qualquer membro (se ativado) |
Onde aparece | Lista de skills de todos | Seção "Compartilhado com você" do destinatário | Diretório da organização |
Os destinatários podem removê-la? | Apenas desativar | Desativar ou excluir | Apenas desativar |
Requer aprovação do proprietário? | Proprietário faz upload diretamente | Não | Não |
Importante: Não há fluxo de trabalho de aprovação para compartilhamento em toda a organização. Se você ativar Compartilhar com a organização, qualquer membro pode publicar uma skill no diretório sem revisão. Considere ativar apenas o compartilhamento ponto a ponto se isso for uma preocupação.
Monitorar atividade de compartilhamento
Eventos de compartilhamento de skill são capturados no log de auditoria e na API de Conformidade como eventos role_assignment. Você pode ver quem compartilhou uma skill, com quem, e se foi ponto a ponto ou em toda a organização.
O log de auditoria não captura o conteúdo de skills compartilhadas—apenas o evento de compartilhamento em si. Não há painel de administrador para procurar ou inspecionar o conteúdo de skills compartilhadas entre membros.
Como membros veem skills provisionadas e compartilhadas
Skills aparecem para cada membro em Personalizar > Skills, organizadas em três seções:
Skills pessoais: Skills que o membro criou ou fez upload.
Compartilhado com você: Skills que colegas compartilharam diretamente com um membro. Estas aparecem acinzentadas até serem ativadas.
Skills da organização: Skills que um proprietário provisionou e skills que membros compartilharam em toda a organização. Os membros instalam estas do diretório.
Skills provisionadas pelo proprietário são marcadas com um indicador visual para que membros possam distingui-las de outros tipos de skill. Os membros podem clicar em qualquer skill para visualizar seu conteúdo e descrição.
Para mais informações sobre como membros navegam e instalam do diretório, consulte Procurar skills, conectores e plugins em um diretório.
Como usuários veem skills provisionadas
Skills provisionadas por um proprietário de organização aparecerão para cada usuário em Personalizar > Skills junto com skills da Anthropic e qualquer skill que eles tenham feito upload.
Estas skills são marcadas com um indicador visual para que usuários possam distingui-las de outros tipos de skill. Os usuários podem clicar em qualquer skill para visualizar seu conteúdo e descrição.
Gerenciar e remover skills provisionadas
A seção Skills da organização em Configurações da organização > Skills exibe todas as skills que foram provisionadas para sua organização. Você pode usar a busca e títulos de seção para navegar suas skills provisionadas.
Para remover uma skill de sua organização, localize-a na lista Skills da organização e selecione a opção para removê-la. Uma vez removida, a skill não aparecerá mais nas listas de Skills dos usuários em Personalizar > Skills.
Nota: Apenas proprietários podem adicionar ou remover skills em toda a organização. Usuários individuais não podem excluir skills provisionadas, embora possam desativá-las para seu próprio uso.
Melhores práticas
Teste skills antes de provisionar: Faça upload e teste skills em sua própria conta primeiro para verificar se funcionam conforme esperado antes de distribuir em toda a organização.
Use nomes descritivos: Dê às skills nomes claros que ajudem os usuários a entender seu propósito à primeira vista.
Escreva descrições claras: A descrição da skill ajuda Claude a determinar quando usá-la automaticamente. Garanta que as descrições reflitam com precisão o que a skill faz.
Considere o status padrão cuidadosamente: Ative skills por padrão quando forem amplamente úteis para a maioria dos usuários. Use desativado por padrão para skills especializadas que apenas alguns membros da equipe precisam.
Decida sobre compartilhamento deliberadamente: O compartilhamento ponto a organização não tem etapa de aprovação. Se você quiser revisar skills antes que elas cheguem a todos, mantenha o compartilhamento em toda a organização desativado e peça aos membros que enviem skills a um proprietário para provisionar.