TL;DR: As Claude Skills são pastas de instruções, scripts e recursos que Claude descobre por conta própria e carrega apenas quando uma tarefa precisa deles. Cada skill é definida por um arquivo SKILL.md, custa quase nada em contexto até ser ativada e funciona em Claude Code, nos aplicativos Claude, Claude Cowork e na API. Este guia de Claude Skills aborda o que são as skills, como funciona a divulgação progressiva, as três maneiras de instalar skills, como as skills se comparam a MCP, comandos e subagentes, além de exemplos reais e melhores práticas.
As Claude Skills mudaram a forma como as pessoas personalizam agentes de IA. Antes das skills, ensinar a Claude seu fluxo de trabalho significava colar as mesmas instruções em cada conversa ou preencher um arquivo de configuração até inchar a janela de contexto. As skills resolvem ambos os problemas: você escreve o procedimento uma vez, e Claude o incorpora automaticamente—mas apenas quando a tarefa corresponde.
Essa única decisão de design é o motivo pelo qual o formato se espalhou tão rapidamente. As skills são pastas simples de Markdown e scripts opcionais, então qualquer pessoa que possa escrever um documento pode criar uma. Elas funcionam da mesma forma em um agente de terminal, um aplicativo de chat e uma integração de API. E como elas ficam fora de contexto até serem necessárias, você pode instalar dezenas sem diminuir nada.
Este guia percorre todo o ciclo de vida: entender o formato, instalar sua primeira skill, escolher entre skills e outros mecanismos de extensão, e escrever skills que Claude reconhece de forma confiável.
O Que São Claude Skills?
As Claude Skills são pastas organizadas de instruções, scripts e recursos que Claude carrega dinamicamente para ter um desempenho melhor em tarefas específicas. Cada skill é construída em torno de um arquivo obrigatório—SKILL.md—que contém um pequeno bloco de metadados (um nome e uma descrição) mais as instruções completas para a tarefa. Esse é o formato obrigatório completo.
Em torno desse arquivo central, uma skill pode agrupar o que for necessário para o trabalho: scripts executáveis, modelos, documentos de referência, listas de verificação ou exemplos de saída. Uma skill de diretrizes de marca pode incluir seus arquivos de logotipo e regras de tom de voz. Uma skill de relatórios pode incluir um script Python que gera o gráfico da mesma forma todas as vezes.
Um exemplo concreto torna a anatomia óbvia. Uma skill de relatório trimestral pode conter um SKILL.md cuja descrição diz "Usar quando o usuário solicitar um relatório de negócios trimestral", instruções que especificam a ordem das seções e o tom, um arquivo de referência contendo o relatório do último trimestre como um padrão ouro, e um script que insere os números em uma tabela formatada. Nada disso é código que Claude precisa adivinhar—é um procedimento, escrito uma vez, seguido todas as vezes.
A parte inteligente é a divulgação progressiva—o modelo de carregamento que mantém as skills baratas. Funciona em três estágios:
- Descoberta — na inicialização, Claude vê apenas o nome e a descrição de cada skill. Isso custa algumas dezenas de tokens por skill, então uma grande biblioteca permanece acessível.
- Ativação — quando sua solicitação corresponde à descrição de uma skill, Claude lê as instruções completas do SKILL.md para o contexto.
- Execução — Claude segue as instruções, abrindo arquivos de referência ou executando scripts apenas se a tarefa realmente os exigir.
As Claude Skills também são portáteis em todo o ecossistema Claude. O mesmo formato de pasta funciona no Claude Code (baseado em sistema de arquivos, sem necessidade de upload), nos aplicativos Claude na web e desktop (onde skills pré-construídas já impulsionam a criação de documentos, e skills personalizadas podem ser adicionadas nas configurações), Claude Cowork (o espaço de trabalho agêntico da Anthropic para não desenvolvedores) e na API Claude e SDK do Agente, onde um endpoint de skills dedicado oferece aos desenvolvedores controle programático e versionamento. Construa uma skill uma vez e ela viaja com você.
Como as Claude Skills Funcionam?
As Claude Skills funcionam por meio da correspondência de descrição: o próprio modelo decide quando uma skill é relevante, a carrega e a aplica—sem necessidade de acionamento manual. Se você pedir a Claude para "elaborar um contato para esses 20 leads" e a descrição de uma skill de contato mencionar e-mail frio, Claude a ativa por conta própria.
Esse é o caminho padrão, invocado pelo modelo, e é o que diferencia as skills de truques de personalização mais antigos. Mas as skills também podem ser invocadas pelo usuário. No Claude Code, cada skill também se registra como um comando de barra, então digitar /nome-da-skill força sua execução. Comutadores de frontmatter permitem que os autores ajustem esse comportamento—por exemplo, desabilitando a invocação automática para um fluxo de trabalho destrutivo para que ele só seja acionado quando um humano o chamar explicitamente.
Aqui está o fluxo completo em uma solicitação real. Você digita "crie uma lista de prospects de chefes de RevOps em fintechs da Série B". Claude escaneia seus metadados de skill, encontra uma skill de prospecção cuja descrição menciona ICP e listas de leads, e lê as instruções completas. Essas instruções dizem quais filtros de pesquisa aplicar, como verificar os dados de contato e qual formato a saída deve ter. Sobrecarga total antes desse momento: uma linha de metadados silenciosamente no contexto.
Saber como usar as Claude Skills no dia a dia é agradavelmente simples: você geralmente apenas pede o resultado. Três propriedades fazem o sistema escalar onde as bibliotecas de prompts nunca conseguiram:
- Componibilidade — as skills se empilham. Uma solicitação pode ativar uma skill de análise de dados, uma skill de voz de marca e uma skill de planilha juntas, cada uma contribuindo com sua parte do fluxo de trabalho.
- Eficiência de tokens — até ser ativada, uma skill custa apenas seus metadados de uma linha. Compare isso com um arquivo monolítico de instruções que queima contexto em cada sessão, seja relevante ou não.
- Determinismo onde importa — scripts empacotados permitem que uma skill execute etapas frágeis (cálculo de datas, conversão de arquivos, saída formatada para API) em código real, em vez de pedir ao modelo para improvisá-las a cada vez.
Como Instalar Claude Skills
Existem três maneiras verificadas de instalar Claude Skills: através de um marketplace de plugins, com a CLI de skills de código aberto, ou soltando uma pasta no seu diretório de skills. Se você estava procurando como adicionar skills ao Claude Code, qualquer uma das três funciona—elas diferem em conveniência e no quanto você confia na fonte.
- 1Instalar de um marketplace de plugins
No Claude Code, execute
/pluginpara abrir o navegador de plugins. A aba Descobrir lista plugins—muitos dos quais agrupam skills—do marketplace oficial da Anthropic. Para adicionar um marketplace da comunidade, execute/plugin marketplace add owner/repocom um repositório GitHub, e então instale a partir de suas listagens. As skills instaladas ficam disponíveis em sua sessão sem reiniciar. - 2Usar a CLI de skills de código aberto
O instalador
npx skills(skills.sh) trata o GitHub como um registro de pacotes para skills—nenhuma conta separada é necessária. Um comando instala e configura uma skill para seu agente. Um exemplo real e funcional:npx skills add LessieAI/lessie-skill -y -ginstala a skill de busca de compradores Lessie globalmente e de forma não interativa. Executenpx skills findpara descobrir mais, ou veja nossa página de integração da CLI de skills para configuração agente por agente. - 3Adicionar uma pasta de skill manualmente
Crie uma pasta contendo um arquivo SKILL.md em
~/.claude/skills/para skills pessoais disponíveis em todos os projetos, ou em.claude/skills/dentro de um repositório para skills de projeto que toda a sua equipe obtém via git. É assim também que você instala skills baixadas do GitHub: descompacte, solte a pasta e peça a Claude para confirmar que vê a skill.
Qualquer que seja o caminho que você escolha, verifique a instalação da mesma forma: inicie uma nova sessão e pergunte a Claude quais skills ele pode ver, ou digite / e procure o comando de barra da skill na lista. Se uma skill nunca se ativa sozinha, a descrição geralmente é a culpada—é o único texto que Claude lê ao decidir a relevância, então ela precisa mencionar as palavras que você realmente usa ao perguntar.
Fora do Claude Code, a instalação é ainda mais simples: nos aplicativos Claude, você habilita skills nas configurações e adiciona as personalizadas lá, enquanto os usuários da API fazem upload das skills uma vez e as referenciam por ID nas solicitações. O formato da pasta é idêntico em todos os lugares, então uma skill que você testa localmente é portada para produção sem edições.
Claude Skills vs MCP, Comandos e Subagentes
A versão curta: as skills empacotam conhecimento e procedimentos, o MCP fornece conexões ao vivo a sistemas externos, os comandos de barra são atalhos invocados pelo usuário, e os subagentes são trabalhadores paralelos com seu próprio contexto. Eles são complementos, não concorrentes—configurações maduras usam todos os quatro.
| Mecanismo | O que é | Quem o aciona | Melhor para | Custo de contexto |
|---|---|---|---|---|
| Skills | Pasta de instruções, scripts e recursos (SKILL.md) | Claude, quando a tarefa corresponde; ou você, via comando de barra | Procedimentos, expertise, fluxos de trabalho repetíveis | Quase zero até ser ativada |
| MCP | Protocolo aberto conectando Claude a ferramentas e dados externos | Claude, sempre que precisa do sistema conectado | Dados ao vivo, APIs, bancos de dados, serviços de terceiros | Definições de ferramentas carregadas enquanto o servidor está conectado |
| Comandos de barra | Atalho de prompt invocado por nome (agora mesclado em skills) | Você, explicitamente | Ações manuais frequentes que você deseja sob demanda | Carregado apenas quando chamado |
| Subagentes | Instância de agente separada com seu próprio contexto e ferramentas | Claude delega, ou você solicita um | Trabalho paralelo ou isolado que poluiria o thread principal | Janela de contexto própria; retorna apenas um resumo |
Claude Skills vs MCP. Uma skill pode ensinar a Claude seus critérios de qualificação, mas não pode acessar um banco de dados ao vivo em tempo de execução—esse é o trabalho do MCP. O MCP, introduzido pela Anthropic no final de 2024, padroniza as conexões a sistemas externos da mesma forma que o USB-C padronizou as portas; as skills padronizam o conhecimento para usá-los. Os dois se combinam naturalmente: o MCP busca os dados, uma skill dita o que fazer com eles. Se você precisa de dados de pessoas do LinkedIn ao vivo, por exemplo, consulte nosso guia de MCP do LinkedIn.
Claude Skills vs comandos. O Claude Code originalmente mantinha comandos e skills como sistemas separados; desde então, eles foram mesclados, e um arquivo Markdown em qualquer local produz a mesma interface de comando de barra. As skills são o formato recomendado daqui para frente porque suportam arquivos agrupados, controles de frontmatter e—crucialmente—invocação de modelo. Um comando espera que você se lembre dele; uma skill se oferece.
Claude Skills vs agentes. Um subagente é um trabalhador; uma skill é um manual. Os subagentes brilham quando o trabalho deve ser executado em paralelo ou ficar fora do seu contexto principal—uma varredura de pesquisa, uma revisão de código. As skills brilham quando o agente principal só precisa saber como. Os padrões se encaixam: um subagente pode carregar skills, e uma skill pode instruir Claude a delegar a subagentes.
Uma regra prática para escolher: se o problema é "Claude não sabe como fazemos isso", escreva uma skill. Se for "Claude não consegue ver os dados", adicione um servidor MCP. Se você continua digitando a mesma solicitação, invoque a skill diretamente como um comando de barra. E se o trabalho for muito grande para uma janela de contexto, entregue-o a um subagente. A maioria das configurações de produção em 2026 executa todos os quatro silenciosamente juntos.
Exemplos e Casos de Uso de Claude Skills
Os melhores exemplos de Claude Skills compartilham uma característica: eles codificam um procedimento que alguém costumava repetir manualmente. Aqui estão cinco padrões já funcionando em produção em vendas, documentos, engenharia e marketing—para uma lista completa e classificada, consulte nosso resumo das melhores Claude Skills.
- Prospecção de Vendas e GTM — a Lessie Skill executa um fluxo de trabalho de outbound completo do terminal: encontra compradores verificados que correspondem ao seu ICP em mais de 100 fontes ativas, os enriquece com contexto de função e empresa, e então elabora um contato personalizado—com 95% de precisão de e-mail. Equipes que usam essa abordagem personalizada por sinal aumentaram as taxas de resposta de cerca de 1% para 12%.
- Produção de Documentos — as próprias skills de documentos da Anthropic (docx, pptx, xlsx e pdf) são o que permitem a Claude produzir arquivos Word, apresentações e planilhas formatados corretamente. Elas são de código aberto e uma aula magistral em agrupar scripts para saída determinística.
- Design Frontend — a skill de design frontend da Anthropic impulsiona Claude além do estilo genérico de IA para interfaces distintas e de nível de produção. As equipes a bifurcam e enxertam seus próprios tokens de design.
- Operações de Conteúdo de Marketing — as skills de voz de marca codificam regras de tom, frases proibidas e formatação para que cada rascunho seja coerente com a marca. Nosso guia de Claude Skills para marketing cobre todo o stack, desde briefs de SEO até relatórios de campanha.
- SOPs e Revisões Internas — as equipes empacotam listas de verificação de lançamento, etapas de revisão de segurança e regras de tratamento de dados como skills de projeto em
.claude/skills/, para que o procedimento seja enviado com o repositório e cada colega de equipe—humano ou agente—siga o mesmo. - Recrutamento e Busca de Talentos — os mesmos mecanismos de busca de compradores se aplicam a candidatos: uma skill de sourcing codifica sua barra de qualificação e estratégia de busca, para que um gerente de contratação possa pedir por "engenheiros de backend sênior abertos a trabalho por contrato" e obter uma lista selecionada e verificada em vez de correspondências de palavras-chave brutas.
Observe a divisão: algumas skills adicionam capacidade (documentos, busca de compradores), outras adicionam julgamento (voz de marca, listas de verificação de revisão). A maioria das equipes acaba querendo ambos, que é exatamente para o que serve a componibilidade. Um único fluxo de trabalho de uma tarde pode encadear três dos exemplos acima: a Lessie Skill constrói a lista, uma skill de voz de marca elabora o contato e as skills de documentos empacotam os resultados em uma apresentação para a revisão de pipeline de segunda-feira.
Melhores Práticas para Claude Skills
As melhores práticas para Claude Skills se resumem a três disciplinas: escrever skills que acionam de forma confiável, mantê-las enxutas o suficiente para serem baratas e tratar as skills de terceiros com a mesma cautela que qualquer código que você executa. Os detalhes:
- Faça a descrição fazer o trabalho. A descrição é a única coisa que Claude vê antes de decidir ativar uma skill. Nomeie a tarefa, os gatilhos e as palavras-chave que um usuário realmente diria—uma descrição vaga é uma skill que nunca dispara.
- Mantenha o SKILL.md focado em uma única tarefa. Uma skill, um fluxo de trabalho. Quando o arquivo fica difícil de gerenciar, divida os detalhes em arquivos referenciados e confie na divulgação progressiva para carregá-los apenas quando necessário.
- Revise as skills de terceiros antes de instalar. As skills podem incluir scripts executáveis, e as próprias instruções podem direcionar um agente de maneiras que você não pretendia. Leia o SKILL.md e cada script agrupado—ou peça a Claude para resumi-los—antes de conceder-lhes um lugar em seu fluxo de trabalho.
- Fixe suas fontes. Instale de repositórios em que você confia, prefira publicadores mantidos em vez de forks aleatórios e revise após as atualizações. Trate um marketplace de skills como um registro de pacotes, porque é isso que ele é.
- Controle de versão de skills de projeto. As skills em
.claude/skills/acompanham seu repositório: as alterações recebem revisão de código, histórico e reversão como qualquer outro arquivo. Essa trilha de auditoria é sua rede de segurança quando um fluxo de trabalho se comporta mal. - Itere a partir de transcrições reais. Quando Claude aplica mal uma skill, a correção geralmente é uma linha esclarecedora nas instruções. As skills recompensam o mesmo ciclo de feedback apertado que os prompts—exceto que você corrige o problema uma vez, permanentemente.
