A resposta curta
Uma Skill é uma pasta com um arquivo SKILL.md dentro. O arquivo começa com um cabeçalho curto que contém um name e uma description, e as instruções vêm depois. O seu agente guarda na memória só o nome e a descrição até que um pedido combine com eles e, então, lê o resto. A mesma pasta funciona no Claude Code, no Codex e no Cursor.
Por que as Skills existem
Você provavelmente já fez isso
Você guarda um prompt de 40 linhas para landing pages de lançamento. Ele descreve o layout, as seções e as verificações na largura de celular. Você cola o prompt toda vez, esquece uma linha em algum momento e a página sai diferente. Aí um colega pede “aquele prompt” e você manda a versão do mês passado.
Uma Skill transforma esse prompt em uma pasta que o seu agente encontra sozinho. Veja a Meridian Marketing Landing: depois de instalada, o agente já conhece o Hero em papel quadriculado, a grade de recursos e o seletor de preços. Você só traz as informações do seu produto.
A maioria dos exemplos de Claude Skills segue o mesmo padrão: um método fixo para um tipo de resultado. A Notion Style OG Image cria uma imagem de compartilhamento 16:9, e outras Skills na Skillry montam apresentações de slides, sites de currículo e vídeos curtos.
| Prompt colado | Skill | |
|---|---|---|
| O que você explica | Layout, seções, estilo e verificações, toda vez | Só o seu conteúdo |
| De uma execução para outra | Muda um pouco a cada vez | Segue os mesmos passos |
| Compartilhar | Procurar no histórico do chat | Instalar a mesma pasta |
O que tem dentro de um arquivo SKILL.md?
Uma Skill precisa de um único arquivo, o SKILL.md, e pode trazer pastas opcionais com documentos de referência, scripts e templates. O arquivo tem duas partes: um cabeçalho curto entre linhas --- e, depois, instruções em texto simples escritas para o agente.
launch-page/
├── SKILL.md required
├── references/ optional: docs read when needed
├── scripts/ optional: code the agent can run
└── assets/ optional: templates and files---
name: launch-page
description: Build a product launch page with a hero, a feature
grid, and a pricing toggle. Use when asked for a launch page.
---
1. Ask for the product name, audience, and three features.
2. Build the hero, the feature grid, and the pricing section.
3. Check the page at phone width before you finish.name
Até 64 caracteres, usando letras minúsculas, números e hífens. Precisa ser igual ao nome da pasta.
description
Até 1.024 caracteres. Diga o que a Skill faz e quando usá-la; o agente depende dessa segunda parte para escolhê-la.
Opcionais
license, compatibility, metadata, allowed-tools
Esses limites vêm da especificação aberta Agent Skills. O Claude Code é mais flexível: você pode omitir o name e ele usa o nome da pasta.
Como um agente decide qual Skill usar?
Ele compara o seu pedido com a descrição de cada Skill. Para que isso saia barato, ele carrega cada Skill em três etapas:
- 1Ao iniciar, ele lê o nome e a descrição de cada Skill instalada. Nada além disso.
- 2Quando o seu pedido combina com uma descrição, ou quando você chama a Skill pelo nome, ele carrega o
SKILL.mdcompleto. - 3Enquanto trabalha, ele abre arquivos em
references/ou rodascripts/só quando as instruções mandam.
É por isso que você pode instalar dezenas de Skills sem deixar o seu agente mais lento. Até ser necessária, uma Skill ocupa mais ou menos uma frase de contexto.
| Agente | Chamar uma Skill pelo nome |
|---|---|
| Claude Code | /skill-name |
| Codex | $skill-name, ou escolha em /skills |
| Cursor | /skill-name, ou @skill-name para anexá-la |
A escolha automática só é tão boa quanto a descrição. Acionamento mostra como escrever uma que seja escolhida. Enquanto isso, chamar a Skill pelo nome sempre funciona.
Quais agentes podem usar Skills?
A maioria dos agentes que você conhece. A Anthropic criou o formato para o Claude e o publicou como padrão aberto em 18 de dezembro de 2025. O site agentskills.io já lista dezenas de ferramentas que o leem, incluindo Claude Code, ChatGPT e Codex, Cursor, VS Code, GitHub Copilot e Gemini CLI.
| Agente | Pasta pessoal |
|---|---|
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.agents/skills/ (também lê a antiga ~/.codex/skills/) |
| Cursor | ~/.cursor/skills/ ou ~/.agents/skills/ |
Uma Skill na sua pasta pessoal fica disponível em todos os projetos do seu computador. As pastas de projeto e todos os outros lugares onde um agente procura estão listados em Locais das Skills.
Skill ou prompt: qual usar?
Transforme em Skill quando você for repetir a tarefa e quiser a mesma qualidade sempre. Para algo pontual, um prompt basta.
Você vai fazer isso de novo
- Precisa de exemplos, scripts ou um checklist
- Você quer o mesmo resultado toda vez
- Outras pessoas também precisam
É algo pontual
- Algumas frases resolvem
- Você ainda está descobrindo o que quer
- Nada ali vale a pena reaproveitar
Na maioria das vezes você usa os dois. O prompt diz o que você quer hoje, e a Skill diz como fazer isso bem. Skills vs prompts se aprofunda no assunto.
O que verificar antes de instalar uma Skill
Uma Skill pode rodar scripts no seu computador, então dê uma lida rápida em cada Skill nova antes.
Uma verificação de cinco minutos
- Leia o
SKILL.mde anote o que ela tem permissão para alterar. - Leia tudo em
scripts/. Esses scripts rodam na sua máquina. - Confira Dependências e Custos externos na página da Skill.
- Mantenha senhas e API keys fora dos arquivos da Skill e fora do chat.
A lista completa está em Segurança. Quando estiver pronto para testar uma, Primeiros passos guia você na primeira instalação.
Perguntas frequentes
O que são Claude Skills?
É como a maioria das pessoas chama as Agent Skills quando as usa no Claude ou no Claude Code. O formato é o mesmo: uma pasta com um arquivo SKILL.md. Essa mesma pasta também funciona no Codex e no Cursor.
Como o Claude sabe qual Skill usar?
Ele compara o seu pedido com a descrição de cada Skill e carrega a que combina. Digitar /skill-name elimina o palpite.
Posso usar Claude Skills de graça?
Uma Skill é só um conjunto de arquivos, então uma Skill gratuita não custa nada. Você ainda precisa de um agente compatível com Skills, como Claude Code, Codex ou Cursor, no plano que esse produto exigir. A Skillry também tem Skills gratuitas, como a Dot Avatar Maker.
Uma Skill é a mesma coisa que um servidor MCP?
Não. Uma Skill ensina um método ao agente, enquanto um servidor MCP o conecta a dados e ferramentas externas. Muitas vezes você vai usar os dois juntos. Veja Skills vs MCP.
Fontes
Este guia ajudou?