Em uma frase: Um SKILL.md tem apenas três partes: o cabeçalho «diz à IA quem você é e quando usá-lo», o corpo é «exatamente como fazer», e os exemplos mostram «como fica o resultado». Este artigo detalha cada campo e depois traz 10 modelos que você pode copiar diretamente.
Para quem está começando do zero, comece pelo tutorial de criação em quatro etapas; este artigo é a referência avançada.
Visão geral da estrutura
---
name: skill-name ← id em minúsculas com kebab-case
description: o que ela faz + quando usá-la ← o mais crítico; a IA decide a ativação com base nisso
---
# Título principal
(corpo: etapas, regras, limites)
## Exemplos
(entrada → saída, para mostrar à IA o nível a atingir)
frontmatter (cabeçalho)
name + description, no formato YAML
Corpo
etapas concretas + limites + regras; quanto mais específico, mais estável
Exemplos
entrada → saída ideal, fixando o padrão que a IA deve produzir
Escrever os melhores campos de cabeçalho
description é a chave
Ela decide «quando a IA se lembra desta Skill». Quanto mais parecida com as palavras do próprio usuário, maior a taxa de acerto.
❌ Muito vago (a IA não saberá quando usá-la)
description: Ajuda a escrever textos publicitários ✅ Preciso (cobertura completa dos cenários de ativação)
description: Escreve publicações de notas de produto no estilo de conteúdo viral curto. Use quando o usuário disser «escreve uma publicação para redes sociais», «me ajuda a redigir um texto promocional do produto» ou colar informações do produto. Convenção de nomenclatura em name
Letras minúsculas + hífens (por exemplo, weekly-report-writer), para que sua função fique óbvia à primeira vista. Não use espaços, maiúsculas nem caracteres não latinos.
10 modelos de cenários prontos para copiar
Salve qualquer um dos modelos a seguir como uma pasta (contendo um SKILL.md com o mesmo nome) e ele vai funcionar — basta trocar os exemplos:
1️⃣ Skill de notas de reunião
---
name: meeting-notes
description: Converte transcrições de reuniões em atas estruturadas. Use quando o usuário colar notas de reunião ou disser «organiza a reunião de hoje».
---
# Ata de reunião
1. Primeiro identifique e exiba: tema, hora, participantes
2. Organize em três seções: «decisões / tarefas pendentes / questões abertas»
3. Uma tarefa por pessoa, formato: responsável + o que fazer + prazo (as informações que faltarem marcadas como [TBD])
4. Não acrescente informações que não estejam nas notas
## Exemplo
Entrada: Na reunião de hoje decidimos adicionar um recurso de exportação ao produto; eu sou responsável pelo backend, Xiao Zhang pelo frontend, demo na sexta...
Saída:
### Decisões
- Adicionar um recurso de exportação ao produto
### Tarefas pendentes
- Ming: implementação da exportação no backend (prazo [TBD])
2️⃣ Skill de polimento de e-mail (tom profissional)
---
name: email-polisher
description: Reescreve rascunhos de e-mail toscos em e-mails profissionais. Use quando o usuário colar um rascunho de e-mail ou disser «dá um trato no meu e-mail».
---
# Polimento de e-mail
1. Preserve todos os pontos de informação importantes
2. Melhore a cortesia da saudação, da abertura e do fechamento
3. Corte as frases longas; uma ideia por parágrafo
4. Saída: e-mail polido + resumo das alterações em 3 linhas ou menos
## Exemplo
Entrada: Oi chefe, a parceria que comentamos está confirmada, quando você quer assinar?
Saída: Prezado Sr. Wang, sobre a parceria mencionada anteriormente, confirmamos que seguiremos em frente. Por favor, nos indique quando seria conveniente para o senhor e poderemos organizar a assinatura como preferir. Cordialmente!
3️⃣ Skill de relatório semanal
---
name: weekly-report
description: Converte registros de trabalho dispersos em um relatório semanal claro e estruturado. Use quando o usuário colar um amontoado de notas ou disser «escreve meu relatório semanal».
---
# Geração de relatório semanal
1. Organize as notas em «resultados desta semana / problemas encontrados / planos da próxima semana»
2. Ordene os resultados por importância, cada um com dados de apoio (acrescente [TBD] se faltar)
3. Ofereça 2 títulos sugeridos para escolher
4. Ater-se aos fatos; não invente acontecimentos que não ocorreram
## Exemplo…
4️⃣ Skill de polimento de currículo
---
name: resume-polisher
description: Aperfeiçoa as descrições do currículo para que fiquem mais profissionais e quantificáveis. Use quando o usuário colar um currículo ou disser «otimiza meu currículo».
---
# Polimento de currículo
1. Comece com verbos de ação (por exemplo, «liderei», «implementei»), evite a primeira pessoa
2. Quantifique os resultados quando possível (números, porcentagens); mantenha o original caso contrário
3. Mantenha cada experiência em 1–2 linhas; corte o supérfluo e o enchimento
4. Saída: lista polida + uma observação sobre o que mudou e por quê
5️⃣ Skill de revisão de código front-end
---
name: frontend-code-review
description: Revisa o código front-end quanto à manutenibilidade e acessibilidade. Use quando o usuário disser «revisa este código» ou colar código.
---
# Revisão de código front-end
1. Verifique cada item: legibilidade / acessibilidade (aria) / desempenho (renderizações repetidas) / segurança (XSS)
2. Para cada problema, informe: arquivo + linha, o problema e o código da solução sugerida
3. Ordene a saída por gravidade
4. Se não houver nenhum problema, diga claramente «nenhum problema encontrado»
6️⃣ Skill de geração de prompts de imagem
---
name: image-prompt-writer
description: Converte uma descrição de cena em um prompt de geração de imagens IA em inglês de alta qualidade. Use quando o usuário disser «escreve um prompt de imagem para mim».
---
# Prompt de geração de imagem
1. Saída em inglês, estruturada: sujeito + ambiente + iluminação + composição + estilo + etiquetas de qualidade
2. Termine com etiquetas de qualidade fixas: high quality, 4k
3. Escolha automaticamente um descritor de estilo adequado à cena (realista / ilustração / 3D / pôster)
4. Depois do prompt, acrescente uma explicação de 2 linhas
7️⃣ Skill de organizador de notas de estudo
---
name: study-notes
description: Organiza material de estudo disperso em notas estruturadas e flashcards. Use quando o usuário colar material ou disser «organiza minhas notas de estudo».
---
# Notas de estudo
1. Extraia os conceitos-chave, cada um começando com uma «definição em uma frase»
2. Organize hierarquicamente por tema, acrescentando exemplos
3. Gere 5 flashcards de perguntas/respostas
4. Saída em Markdown pronta para importar em um app de notas
8️⃣ Skill de interpretação de análise de dados
---
name: data-interpreter
description: Interpreta um conjunto de dados (tabela/números) e apresenta conclusões e recomendações. Use quando o usuário colar dados ou disser «analisa estes dados».
---
# Interpretação de dados
1. Resuma primeiro a visão geral e depois liste as tendências/valores atípicos notáveis
2. Distinga «fatos dos dados» de «inferências»; rotule toda inferência
3. Dê 3 ou mais sugestões de próximos passos acionáveis
4. Exiba as comparações em forma de tabela
9️⃣ Skill de roteiro de vídeos curtos
---
name: short-video-script
description: Converte um tema em um roteiro de vídeo curto falado de 30–60 segundos. Use quando o usuário disser «escreve um roteiro de vídeo curto» ou «converte este texto em roteiro de vídeo».
---
# Roteiro de vídeo curto
1. Estrutura: gancho de 3 segundos + núcleo de 15 segundos + chamada para ação final
2. Deixe falado: frases curtas, tom descontraído, marcas de pausa
3. Dê uma indicação visual a cada 10 segundos (plano / legenda)
4. Fique abaixo de 45 segundos, cerca de 300 palavras
🔟 Skill de planejamento de viagem
---
name: travel-planner
description: Produz um roteiro de viagem conforme duração/orçamento/preferências. Use quando o usuário disser «me ajuda a planejar uma viagem» ou «faz um guia de viagem para mim».
---
# Planejamento de viagem
1. Confirme primeiro as entradas: número de dias, orçamento, origem e destino, preferências (gastronomia / natureza / cultura)
2. Programe cada dia manhã/meio-dia/noite: atrações + transporte + refeições
3. Marque o tempo de visita previsto em cada atração
4. Inclua: uma tabela de orçamento estimado + 3 dicas práticas (como reservas/clima)
A ideia dos modelos: transformar «fluxos de trabalho repetidos com alta frequência» em uma Skill é um uso mais avançado do que salvar prompts nos favoritos — instale uma vez e a IA seguirá o seu padrão sempre depois disso.
Dicas avançadas: tornar as Skills mais estáveis
- Acrescente «contraexemplos»: escrever «não faça X» no corpo reduz bastante os excessos (por exemplo, «não invente dados», «não mude nomes quando não tiver certeza»)
- Especifique o formato de saída: exija explicitamente «formato de tabela», «cabeçalhos ###», «3 linhas ou menos» — a estrutura de saída da IA fica mais estável
- Ancore com exemplos no final: os exemplos não são apenas decorativos; são a referência que alinha a IA ao padrão de produção
- Use scripts/ para o trabalho mecânico: deixe o cálculo e a formatação repetitivos para os scripts; o SKILL.md apenas «dirige»
- Aperfeiçoe de forma iterativa: teste 3 entradas → acrescente ao corpo os pontos em que a IA errou → teste de novo; as Skills ficam mais precisas quanto mais você as usa
Leituras relacionadas
- Começo em quatro etapas: tutorial de criação
- Fundamentos das Skills: artigo explicativo
- Skills excelentes como referência: as 10 que mais vale a pena instalar (o repositório oficial da anthropics é um excelente modelo)