Habilidades de agente

Uma habilidade de agente é uma pasta reutilizável de instruções e arquivos de suporte para uma tarefa específica. O arquivo SKILL.md explica quando e como o agente deve usá-la. Algumas habilidades também incluem scripts, exemplos ou material de referência. Um agente de IA compatível lê esses arquivos para orientar o trabalho do agente; a pasta não é um aplicativo independente.

Um prompt dá instruções a um assistente de IA em uma conversa. Uma habilidade reúne um fluxo de trabalho repetível com instruções reutilizáveis e, quando necessário, arquivos de apoio. Use um prompt para uma solicitação rápida; considere uma habilidade quando você precisar repetidamente do mesmo processo ou material de referência. Você ainda fornece o objetivo e o contexto para cada tarefa.

Pesquise pelo resultado que você quer, como copywriting, pesquisa de concorrentes ou teste de sites. Compare as tarefas, os pré-requisitos e o resultado esperado na página de detalhes. Comece com uma habilidade que corresponda a uma tarefa real pequena e verifique se seu agente tem acesso a arquivos, rede ou capacidade de execução de que ela precisa.

Abra a página de detalhes da habilidade e baixe o ZIP no GitHub. Mantenha a pasta completa, incluindo SKILL.md, referências, scripts e licença. Adicione-a usando o método de instalação de habilidades do seu agente, conclua os pré-requisitos listados e confirme que o agente consegue detectá-la. Depois, envie a solicitação de exemplo com seus próprios materiais e verifique o resultado esperado.

Extraia a pasta da habilidade em .claude/skills/<name>/ dentro do seu projeto. O SKILL.md deve ficar diretamente nessa pasta, e não dentro de outra cópia aninhada dela. Use o nome original da habilidade ao pedir que o Claude Code a aplique. Instale separadamente as dependências de ambiente de execução ou de serviços externos listadas na página de detalhes da habilidade.

Coloque a pasta extraída da habilidade em .agents/skills/<name>/ dentro do seu projeto, com o SKILL.md diretamente nela. Confirme que o Codex encontrou a habilidade antes de iniciar uma tarefa. Uma pasta baixada não configura automaticamente ferramentas externas, contas ou ambientes de execução; siga os pré-requisitos da habilidade específica.

Se habilidades personalizadas estiverem disponíveis para sua conta e organização, envie o ZIP em Personalizar → Skills e ative a habilidade. Mantenha a pasta da habilidade e os arquivos de apoio juntos no arquivo. Habilidades que dependem de software local ou de conexões indisponíveis podem precisar de outro ambiente, mesmo quando o envio é bem-sucedido.

Verifique o local da pasta, se há um diretório aninhado extra e se o SKILL.md está presente. Confirme que o agente atualizou a detecção de habilidades e reinicie a sessão se sua ferramenta exigir isso. Se a habilidade for reconhecida, mas a tarefa falhar, verifique o ambiente de execução, o acesso à rede, as conexões externas e os arquivos de entrada necessários. Só baixar o ZIP não resolve essas dependências.

Você pode pedir a um agente que ofereça suporte a chinês para trabalhar com materiais em chinês e gerar saída em chinês. Especifique o idioma, o público e a terminologia desejados na sua solicitação. Os resultados dependem do agente e da habilidade, então verifique a saída com base nos requisitos da sua tarefa.

Os arquivos desta coleção estão disponíveis no repositório público open-source-skills e em suas GitHub Releases, com a atribuição de autoria original e as licenças preservadas. Leia a licença incluída da habilidade específica. O download é gratuito; a ferramenta de IA ou os serviços externos que você usar podem cobrar à parte.

Compare a versão de origem na página de detalhes com a cópia instalada. Salve suas próprias alterações antes de substituir a pasta por um pacote completo mais recente e, depois, repita uma tarefa pequena para verificar. Em uma instalação manual, remova a pasta específica do diretório de habilidades do agente. Se você usou um instalador, siga o processo de atualização ou remoção dele.

A coleção atual passa por verificações de origem, licença e conteúdo do pacote. Isso não significa que toda habilidade tenha concluído tarefas reais em todos os agentes. Revise os arquivos e os pré-requisitos antes de ativar uma habilidade e verifique fatos, citações, código gerado e ações propostas na saída dela. Os exemplos descrevem resultados esperados, não demonstrações verificadas.