Claude Skills: o que é skill, onde fica e como o Claude usa

Quem começa a usar IA no trabalho logo percebe que perde tempo demais repetindo as mesmas regras em toda conversa nova. Uma skill resolve exatamente isso: você guarda o passo a passo de uma entrega dentro de uma pasta, e o Claude passa a executar o trabalho no seu padrão sem que você precise colar instruções enormes no chat. Aqui você vai ver o que existe dentro de um arquivo SKILL.md, em qual pasta ele mora no seu computador, como o Claude escolhe a skill certa e quais delas eu uso todos os dias na minha operação.

O que é skill no Claude

Pense numa skill como um manual de bolso para uma tarefa específica. Em vez de digitar toda vez um pedido longo como “monte um carrossel de 7 telas no tom da marca do cliente e finalize com uma chamada para o WhatsApp”, você escreve esse roteiro uma única vez num arquivo, e o Claude consulta essa receita sempre que a demanda surgir. A própria documentação da Anthropic recomenda criar uma skill sempre que você se pegar colando o mesmo checklist ou procedimento de várias etapas no chat.

Tecnicamente, a Anthropic define uma skill como uma pasta que reúne instruções em texto, scripts e arquivos de apoio carregados sob demanda pelo Claude. Esse recurso foi lançado em outubro de 2025 e, em dezembro do mesmo ano, foi publicado como um padrão aberto chamado Agent Skills, permitindo que a mesma pasta funcione em outras ferramentas de IA.

Se você já usava comandos personalizados no Claude Code antigamente, vale saber que eles foram unificados com as skills. Um arquivo antigo salvo em .claude/commands/deploy.md e uma skill nova em .claude/skills/deploy/SKILL.md criam exatamente o mesmo atalho /deploy, e os arquivos antigos seguem funcionando sem precisar migrar. Além disso, o próprio Claude Code já traz algumas skills nativas de fábrica, como /code-review, /debug e /loop. Para listar todas as que estão ativas no seu ambiente, basta digitar /skills no chat.

O que tem dentro de um SKILL.md

Toda skill mora dentro de uma pasta própria e tem um arquivo principal chamado SKILL.md, escrito com letras maiúsculas. No topo desse arquivo vai um pequeno cabeçalho delimitado por três traços (---) com o nome e a descrição da habilidade; logo abaixo entram as instruções em português claro, do mesmo jeito que você explicaria a tarefa para alguém da sua equipe. Veja um exemplo simples de uma skill feita para resumir reuniões com clientes:

Dentro da mesma pasta da skill, você também pode guardar arquivos extras, como um modelo de contrato, exemplos de textos aprovados ou scripts auxiliares, indicando dentro do SKILL.md em qual momento o Claude deve abrir cada um deles. A recomendação oficial é manter o SKILL.md principal enxuto, com menos de 500 linhas, deixando os materiais longos nesses arquivos secundários. Veja como é um arquivo SKILL.md oficial da Anthropic por dentro:

Como criar a sua primeira skill

1. 1Abra a pasta do seu projeto no VS Code e crie dentro dela o caminho .claude/skills/resumo-da-call. O nome dessa última subpasta será o nome do comando.
2. 2Dentro da pasta resumo-da-call, crie um arquivo chamado SKILL.md e preencha o cabeçalho e as instruções seguindo o modelo da tabela acima.
3. 3Se a pasta .claude/skills ainda não existia quando você iniciou a sessão do Claude Code, digite /reload-skills no chat para que ele reconheça a pasta nova sem precisar fechar o editor. Se ela já existia, o reconhecimento é imediato.
4. 4Digite / na caixa de mensagem do Claude Code e confira se o atalho /resumo-da-call já aparece na listagem.
5. 5Faça o teste prático das duas maneiras: primeiro acionando o comando /resumo-da-call diretamente, e depois apenas pedindo no chat algo como “faça o resumo da reunião que está no arquivo reuniao.md”.

Você nem precisa escrever o arquivo na mão se não quiser: basta explicar no próprio chat do Claude Code qual tarefa a skill deve cumprir, quando ela deve entrar em ação e em qual pasta salvá-la, que ele monta o SKILL.md para você, como detalho no passo a passo de como criar uma skill no Claude. A própria Anthropic mantém um utilitário oficial chamado skill-creator que cria e testa skills novas, e eu mostro como baixá-lo no guia sobre como instalar skills no Claude Code.

Onde a skill fica no seu computador

O local onde você guarda a pasta da skill define em quais projetos ela estará disponível. No dia a dia com o Claude Code, existem quatro endereços principais:

Há um detalhe técnico nessa estrutura que explica a dúvida mais comum de quem está começando. Quando a pasta .claude/skills fica escondida dentro de uma subpasta abaixo daquela que você abriu no VS Code, o Claude Code não carrega essas skills na inicialização e elas não aparecem no menu /. Nesse cenário, elas só são descobertas quando o Claude precisa ler ou editar algum arquivo dentro daquela subpasta específica.

É exatamente isso que acontece quando alguém baixa o MazyOS e abre no VS Code uma pasta geral do computador em vez da pasta do próprio MazyOS: como o diretório .claude ficou um nível abaixo, a barra / não lista os comandos. Para resolver na hora, basta abrir no VS Code a pasta que contém o .claude direto na raiz, seguindo o passo a passo do FAQ para quando os comandos do MazyOS não aparecem.

E como o formato SKILL.md segue o padrão aberto Agent Skills, o mesmo arquivo funciona nas outras ferramentas de IA sem alterar uma vírgula, mudando apenas o nome da pasta onde você o guarda. No Codex da OpenAI, o endereço certo é a pasta .agents/skills do projeto (ou a ~/.agents/skills, pra valer em todo projeto), como mostro no guia de como configurar skills no Codex. No Antigravity do Google, o sistema lê a pasta .agents/skills do projeto (a .agent/skills, o nome antigo, ainda funciona); as skills que valem pra todo projeto ficam em ~/.gemini/config/skills, no app e no IDE. Já o Grok Build da xAI lê sozinho, sem configurar nada, o CLAUDE.md, as regras da pasta .claude/rules, as skills, os plugins, os hooks, os agentes e os MCPs do Claude Code, e também o AGENTS.md.

Como o Claude acha a skill certa

O Claude Code não despeja o texto inteiro de todas as suas skills na conversa de uma vez só. Ao iniciar a sessão, ele lê apenas o nome (name) e a descrição (description) do cabeçalho de cada uma, carregando o restante do arquivo SKILL.md somente no instante em que aquela tarefa é acionada. A Anthropic chama esse mecanismo de divulgação progressiva, e é graças a ele que você pode ter manuais detalhados sem travar a memória da conversa logo na largada.

Por esse motivo, a linha description é a peça mais importante do cabeçalho. Se a descrição não trouxer os termos que você costuma usar quando pede aquela entrega no chat, o Claude não vai associar o seu pedido à skill sozinho. Quando notar isso, você pode tanto chamar o atalho direto com /nome quanto ajustar o texto da descrição para o seu vocabulário. Você também pode controlar quem dispara a skill usando três modos:

• Acionamento por você e pelo Claude (padrão). Você pode digitar /nome no chat ou deixar o próprio Claude carregar a skill automaticamente quando o seu pedido bater com a descrição.
• Acionamento exclusivo por você. Adicionando disable-model-invocation: true no cabeçalho, o Claude nunca dispara a skill por conta própria. É o ideal para ações sensíveis que só devem rodar quando você mandar, como publicar alterações ou enviar arquivos.
• Acionamento exclusivo pelo Claude. Com user-invocable: false no cabeçalho, a skill sai da lista do menu / e funciona como uma base de referência silenciosa que o Claude consulta nos bastidores quando precisa.

Mesmo com o carregamento progressivo, lembre que a descrição curta de cada skill instalada entra em todas as mensagens da sessão. Por isso, sair baixando pacotes com dezenas de skills que você nunca usa acaba gerando ruído e consumindo espaço da janela de contexto à toa. A partir da versão 2.1.252 do Claude Code, você pode rodar o comando /skill-doctor para ver exatamente quantos tokens cada skill consome e quantas vezes ela foi usada, facilitando limpar o que está parado.

Skill, CLAUDE.md, MCP e projeto: qual a diferença

Se você quiser ver na prática o que é MCP e como conectar servidores no Claude Code para integrar ferramentas externas, gravei uma aula aberta no meu canal mostrando a configuração passo a passo em MCP + Claude Code. Já a memória de longo prazo que faz o Claude conhecer o histórico de cada empresa de um dia para o outro não mora na skill, mas nos arquivos da pasta de trabalho, como detalho na explicação sobre por que o Claude não esquece o cliente no MazyOS.

Também vale não confundir uma skill com um agente de IA. Enquanto a skill é o roteiro de trabalho que o Claude segue no seu computador quando você pede uma entrega, o agente de IA é um sistema configurado para atender os clientes de uma empresa sozinho, direto no WhatsApp ou no site, tirando dúvidas e qualificando pedidos 24 horas por dia.

Skill, prompt e subagente

Depois de “o que é skill”, uma dúvida que sempre aparece é qual a diferença entre skill e prompt, e onde entra o subagente. Os três são texto que você escreve pro Claude. O que muda é quanto tempo dura e onde roda:

Na prática os três se misturam. O prompt que deu certo três vezes vira skill, como mostro em como criar uma skill. E o subagente pode levar skill junto: no arquivo dele, o campo skills já entrega o conteúdo delas logo no começo, pra ele não ter que procurar. O caminho contrário também existe, a skill com context: fork no cabeçalho roda dentro de um subagente, separada da sua conversa. Nos dois casos o subagente começa sem saber nada do que você falou com o Claude, então tudo que ele precisa tem que estar escrito.

Skills no claude.ai e no app

As skills não ficam restritas ao terminal ou ao VS Code: elas também funcionam no navegador (claude.ai) e no aplicativo do Claude em todos os planos, inclusive no gratuito, bastando que o recurso de execução de código esteja ativado. As skills nativas da Anthropic para criar e editar arquivos de Excel, Word, PowerPoint e PDF já vêm prontas e entram em ação automaticamente quando você pede um documento.

1. 1No navegador, acesse o claude.ai e abra o menu Settings > Capabilities (Configurações > Capacidades).
2. 2Ative a chave Code execution and file creation, que libera a execução de código e a geração de arquivos.
3. 3Abra a seção Customize > Skills (Personalizar > Skills) para ver a lista de habilidades disponíveis e ativar ou desativar cada uma na chave lateral.
4. 4Se quiser enviar uma skill personalizada para a sua conta web, compacte a pasta dela num arquivo .zip, clique no botão +, selecione + Create skill e finalize em Upload a skill.

Todas as skills que você deixa ligadas na sua conta do claude.ai são sincronizadas automaticamente com o Claude Code quando você faz login com o mesmo e-mail, aparecendo na listagem do comando /skills identificadas como claude.ai sync.

Agent Skills, o padrão aberto

O SKILL.md não é um formato fechado da Anthropic. Ela criou e, em dezembro de 2025, publicou como padrão aberto: o Agent Skills, com especificação própria no agentskills.io. A regra mínima é a que você viu aqui em cima: uma pasta com um SKILL.md dentro, com name e description no cabeçalho e as instruções embaixo. Script, documento de apoio e modelo são opcionais.

Duas regras da especificação pegam muita gente. O name vai só com letra minúscula, número e hífen, até 64 caracteres, e tem que ser igual ao nome da pasta. A description vai até 1.024 caracteres e diz o que a skill faz e quando usar. E todo agente que segue o padrão lê do mesmo jeito que o Claude: no começo, só o nome e a descrição de cada skill; o resto, quando a tarefa pede.

Quem segue o padrão: em 26 de outubro de 2026, a vitrine oficial listava 46 produtos, entre eles o Claude, o Claude Code, o ChatGPT e o Codex, o Cursor, o GitHub Copilot, o VS Code e o Gemini CLI, e a documentação do Antigravity também aponta pro padrão. É por isso que as skills do Shopping de skills, puxadas de diretórios como o skills.sh, rodam no Codex e no Antigravity, e não só no Claude. As que valem a pena pra começar tão em as melhores skills pro Claude Code.

O que não viaja são os campos que o Claude Code acrescentou ao padrão, como o context: fork e os hooks escritos dentro da skill, os gatilhos que rodam sozinhos. No Codex e no Antigravity a skill funciona, só que sem eles.

Skill no ChatGPT, no Gemini e no Codex

Skill de IA deixou de ser coisa só do Claude: as outras IAs também ganharam skill, com esse mesmo nome. O que muda é onde ela fica e como você chama:

• No ChatGPT, as skills ficam em Plugins, na aba Habilidades, e a conta já vem com o skill-creator, que monta a skill conversando com você. Pra chamar uma, você digita @ e escolhe. Em 26 de outubro de 2026, a central de ajuda da OpenAI dizia que elas estão no ChatGPT Business, Enterprise, Healthcare e Edu, e o Plus não aparecia na lista.
• No Gemini, o app ganhou skills no lugar dos Gems. O Google anunciou em 30 de setembro de 2026, pra todos os planos de assinatura do Google AI: você chama com / e o nome, pode juntar mais de uma no mesmo pedido, e os Gems das contas pessoais saem em novembro de 2026, virando skill sozinhos.
• No Codex, o lugar das skills é a pasta .agents/skills do projeto (ou a ~/.agents/skills, pra valer em todo projeto). Você chama com $ ou com o /skills, e o $skill-creator e o $skill-installer já vêm dentro. O passo a passo tá em skills no Codex.
• No Antigravity, o lugar é a pasta .agents/skills do projeto (a .agent/skills, o nome antigo, ainda funciona); as skills que valem pra todo projeto ficam em ~/.gemini/config/skills, no app e no IDE. O agente escolhe a skill pela descrição, igual ao Claude, e tá tudo em skills no Antigravity.

E a skill que você escreveu pro Claude é o mesmo arquivo que essas ferramentas leem. No Gemini, por exemplo, você sobe o SKILL.md pronto nas configurações, em Habilidades, e ele já entra:

As skills que eu uso pra vender site

Na prática, o MazyOS é a estrutura de pastas e o pacote de skills que eu criei e uso todos os dias para entregar sites, propostas e campanhas para os meus clientes. Em vez de baixar prompts genéricos na internet, você já recebe todas as skills do fluxo comercial prontas e conectadas entre si:

• Criação de site sob medida, que monta a página completa do cliente com identidade visual própria logo nas primeiras aulas práticas.
• `/carrossel`, que estrutura e escreve carrosséis alinhados ao posicionamento e ao tom de voz da empresa.
• `/proposta`, que gera a proposta comercial fechada em PDF, já com escopo detalhado, ancoragem de preço e termos de garantia.
• `/anuncio-google`, `/anuncio` e `/seo`, voltadas para estruturar campanhas de tráfego pago e otimização para buscas locais.
• `/novo-projeto`, `/atualizar` e `/salvar`, os comandos de gestão que abrem a pasta individual de cada cliente, registram o que foi decidido na sessão do dia e enviam o backup seguro para o GitHub.

Eu mostro como aplicar cada um desses comandos em projetos reais dentro do curso de Claude Code que acompanha o MazyOS.

O que separa esse pacote de uma skill avulsa baixada na internet é a integração com o contexto do projeto. Quando você roda o comando /instalar pela primeira vez, o MazyOS faz uma entrevista estruturada sobre o seu negócio e cria uma pasta própria para cada cliente que você atende. Assim, quando você aciona o /novo-projeto, cria a prévia do site e roda o /proposta, todas as skills leem os dados reais daquela empresa antes de escrever uma linha. O Roberto, que já tinha agência tradicional, mandou mensagem no grupo impressionado com a diferença de ritmo, pois reduziu um trabalho operacional que antes levava trinta dias na agência para apenas duas horas usando as skills estruturadas do MazyOS:

Para ver todas as skills do MazyOS em ação, basta abrir a pasta do sistema no VS Code e digitar / no chat do Claude Code, onde elas aparecem integradas à lista de comandos conforme detalho no resumo sobre o que vem pronto nas skills do MazyOS. E, se você quiser adicionar habilidades externas como o pacote de design oficial da Anthropic, confira agora o tutorial completo de como instalar skills no Claude Code.