skills do claude: o que são e como criar a tua primeira — Ratos de IA
skills

skills do claude: o que são e como criar a tua primeira

skills do claude são pastas com um SKILL.md que ensinam um processo teu pro agente. o que são, a diferença pra prompt e MCP, e como criar a primeira passo a passo.

por · 14 nov 2026

skills do claude: o que são e como criar a tua primeira

aqui na Ratos de IA (o canal no YouTube onde eu, o Dudu, mostro IA na prática toda semana) a gente manda uma newsletter toda semana com o que rolou no vídeo, e ela sai de uma skill. é um arquivo de texto que ensina o Claude a pegar a transcrição do episódio (o vídeo semanal do canal) e devolver a newsletter no nosso formato, com o nosso tom. as skills do Claude são isso: uma pasta com um arquivo SKILL.md que guarda um processo teu, pra tu explicar uma vez e o agente repetir do mesmo jeito sempre. nesse post eu mostro o que é uma skill, a diferença pra prompt, MCP e agente, como é o arquivo por dentro e como criar a tua primeira.

pra ter uma ideia do quanto isso pegou aqui: hoje o repositório da DobraLabs (o laboratório de design, tecnologia e IA por trás do canal; repositório é a pasta de trabalho do time, versionada com git) tem 49 skills na raiz e mais 42 só na pasta de produção do Ratos de IA. tem skill pra proposta comercial, pra relatório de anúncio, pra descrição do YouTube, pra fechar a sessão de trabalho. quase tudo que a gente faz mais de duas vezes vira uma.

o que é uma skill do claude

uma skill do Claude é uma pasta com um arquivo SKILL.md dentro. o arquivo tem um cabeçalho curto (nome e descrição) e, embaixo, as instruções em texto comum. a pasta pode levar junto o que a tarefa precisar: um template, um exemplo aprovado, um guia de estilo, um script.

o que faz a skill funcionar é a descrição. segundo a documentação do Claude Code, numa sessão normal o Claude mantém só as descrições das skills no contexto, pra saber o que tem disponível, e carrega o conteúdo inteiro quando a skill é usada. a Anthropic chama isso de carregamento progressivo. na prática, tu pode ter dezenas de skills instaladas e o Claude só lê a que interessa naquela hora.

tem dois jeitos de uma skill rodar:

e um detalhe que confunde muita gente: os comandos personalizados antigos do Claude Code (os arquivos em .claude/commands/) foram juntados às skills. a doc diz que .claude/commands/deploy.md e .claude/skills/deploy/SKILL.md criam o mesmo /deploy. a skill só ganha a pasta pros arquivos de apoio e o disparo automático.

skill, prompt, CLAUDE.md, MCP e agente: qual a diferença

essa é a pergunta que mais aparece na Comunidade (o grupo de alunos que estuda IA com a gente), porque os cinco nomes parecem a mesma coisa. a tabela resume como a gente separa:

o quêserve praquando carregaexemplo nosso
promptpedir uma coisa uma vezsó naquela mensagem”resume esse e-mail”
CLAUDE.md / AGENTS.mdregras e fatos que valem sempretoda sessão, desde o começo”português do Brasil, sem travessão”
skillum processo que se repetequando o pedido bate com a descrição/newsletter, /fechar
MCPconectar um sistema de foraas ferramentas aparecem quando precisaCanva, Supabase
agente (subagente)um trabalhador separado, com contexto próprioquando o Claude delegapesquisar 10 fontes em paralelo

a régua prática: se tu cola o mesmo prompt toda semana, ele quer virar skill. se é uma regra curta que vale pra tudo, vai no arquivo de instruções do projeto, o CLAUDE.md ou o AGENTS.md. se o Claude precisa mexer num sistema que não está na tua pasta, aí entra o MCP. e na dúvida entre skill e agente, começa pela skill: ela gasta bem menos token.

como é o SKILL.md por dentro

o arquivo é texto com um cabeçalho entre ---. esse aqui é um modelo simples, no formato que a gente usa:

---
name: proposta-comercial
description: gera proposta comercial em HTML no padrão da casa. usar quando
  pedirem proposta, orçamento ou escopo pra cliente.
---

# como montar a proposta

1. ler o briefing e listar o que o cliente pediu
2. usar o template.html desta pasta como base, sem mudar as cores
3. o preço vem depois da prova, nunca antes
4. no fim, perguntar se quer a versão com parcelamento

o que cada parte faz:

no padrão aberto (agentskills.io), name e description são o mínimo. no Claude Code tem campos extras, tipo disable-model-invocation: true, que impede a skill de disparar sozinha (bom pra coisa que publica site ou manda mensagem) e deixa ela rodar só quando tu chama.

a doc também sugere manter o SKILL.md com menos de 500 linhas e mandar o material longo pra arquivos do lado (referencia.md, exemplos.md), citados dentro do SKILL.md. o Claude só abre esses arquivos quando precisa.

como criar a tua primeira skill, passo a passo

o jeito que eu mais recomendo pra quem está começando é fazer a tarefa uma vez com o Claude e só depois transformar em skill. assim tu ensina o processo que já deu certo, com os ajustes que tu fez no caminho.

  1. escolhe uma tarefa que tu repete. relatório da semana, resposta de orçamento, legenda de post. uma só, pequena
  2. faz ela uma vez numa conversa com o Claude. corrige até ficar do jeito que tu quer
  3. pede pra virar skill. algo como: “transforma o que a gente fez aqui numa skill chamada relatorio-semanal, com os passos e as correções que eu pedi”. o Claude Code tem o skill creator, uma skill da própria Anthropic que te entrevista e escreve o arquivo; no episódio em que a Anthropic lançou a versão nova dele a gente testou e a skill ficou com 92% de nota contra 83% sem ela (detalhes no post da DobraLabs sobre o teste A/B das skills)
  4. salva no lugar certo. se é só tua e vale pra tudo, ~/.claude/skills/relatorio-semanal/SKILL.md. se é do projeto e o time vai usar, .claude/skills/relatorio-semanal/SKILL.md dentro da pasta do projeto
  5. testa dos dois jeitos. chama /relatorio-semanal e vê se sai certo. depois abre uma conversa nova e pede com outras palavras (“monta o relatório dessa semana”), pra ver se ela dispara sozinha
  6. ajusta a descrição. não disparou, a descrição está vaga. disparou na hora errada, está ampla demais

no Claude do navegador e do app também dá. a central de ajuda da Anthropic manda ligar a execução de código em Settings › Capabilities, compactar a pasta da skill num ZIP e subir em Customize › Skills, no botão ”+”.

se tu quer as cinco formas de criar, incluindo a de gravar a tela fazendo a tarefa, tem o nosso guia de como criar skill no Claude.

exemplos das skills que a gente usa

três que rodam toda semana aqui, pra tu ver o tamanho real da coisa:

o padrão que se repete nas três: descrição com as frases que a pessoa realmente fala, uma tarefa por skill e exemplo aprovado na pasta quando o tom importa.

os erros mais comuns ao criar skill

pelo que a gente vê na Comunidade e pelas cagadas que a gente mesmo fez:

skill do claude roda em outro agente?

roda, e isso é o melhor argumento pra investir tempo em skill. a Anthropic lançou as skills em outubro de 2025, publicou o formato como padrão aberto em dezembro de 2025 e, em 22 de outubro de 2026, doou o Agent Skills pra Agentic AI Foundation, a fundação da Linux Foundation que já cuida do MCP. segundo o anúncio, mais de 70 plataformas leem o formato, entre elas ChatGPT, Cursor, GitHub Copilot e VS Code.

a gente comentou a doação no episódio #39, com uma alfinetada: o Claude ainda procura as skills na pasta .claude, e o resto do mercado usa .agents. aqui a gente resolveu com um atalho de sistema: a pasta real é .claude/skills e o .agents/skills aponta pra ela, então o Claude Code e o Codex leem as mesmas 49 skills da raiz. o passo a passo está no nosso guia de vários agentes num repositório só.

se tu ainda está chegando no Claude Code, começa pelo post de o que é o Claude Code e como começar e volta aqui pra primeira skill. escolhe a tarefa mais chata da tua semana e transforma ela hoje. a primeira versão sai meia-boca, e tudo bem: tu ajusta o arquivo e ela fica melhor a cada uso.

perguntas frequentes

ainda em dúvida?

o que é uma skill do Claude?

é uma pasta com um arquivo SKILL.md que guarda um processo teu. o cabeçalho diz o nome e quando usar, e o corpo traz as instruções. o Claude carrega a skill quando o pedido bate com a descrição, ou quando tu chama com /nome-da-skill.

precisa saber programar pra criar uma skill?

não. o SKILL.md é texto comum com um cabeçalho curto. dá pra pedir pro próprio Claude escrever a partir de uma conversa que deu certo. script só entra se a tarefa pedir, e mesmo assim o Claude escreve pra ti.

qual a diferença entre skill e MCP?

a skill ensina como fazer uma tarefa (o processo, o padrão, o tom). o MCP conecta o Claude a um sistema de fora, tipo Gmail, Notion ou Canva, e dá ferramentas pra ler e mexer nele. muita skill boa usa um MCP por baixo.

onde fica a pasta de skills do Claude Code?

as tuas, que valem pra todo projeto, ficam em ~/.claude/skills/<nome>/SKILL.md. as do projeto, que o time usa junto pelo repositório, ficam em .claude/skills/<nome>/SKILL.md dentro da pasta do projeto.

skill do Claude funciona no Codex ou no ChatGPT?

funciona. o formato virou padrão aberto (Agent Skills) e, segundo a Anthropic, mais de 70 plataformas já leem, incluindo ChatGPT, Cursor, GitHub Copilot e VS Code. o que muda é a pasta onde cada agente procura.

black friday da ratos · lote 2
tudo que a gente ensina, a Ratoeira e a comunidade, numa assinatura só.

os cursos inteiros, as skills que a gente usa no dia a dia, a Ratoeira pra rodar teus agentes numa máquina tua e a comunidade pra trocar com quem tá fazendo o mesmo. no lote 2 da Black sai por 12x de R$ 113,46 ou R$ 1.097 à vista, e o preço sobe a cada lote.

ver a oferta da Black → 7 dias de garantia
últimos posts
Tutoriais criativo de anúncio com IA: os 3 formatos da meta, na tua marca, sem texto torto Tutoriais google ads pelo claude code: termos de busca, negativas e quality score numa conversa Tutoriais rotinas: o agente de ia trabalhando sozinho num horário
guias da ratos
ver todos os guias →
🔷 a Ratos é feita pela DobraLabs
laboratório de IA que testa inteligência artificial de verdade no próprio dia a dia pra ensinar e construir pra empresas: workshops in-company, automações e sistemas sob medida.
conhecer a dobralabs →