A resposta curta
- 1Na primeira vez, chame pelo nome:
/skill-nameno Claude Code e no Cursor,$skill-nameno Codex. - 2Coloque seus dados, arquivos e tamanhos nessa mesma mensagem.
- 3Abra os arquivos que ela criou e peça uma alteração específica de cada vez.
Entregue tudo na primeira mensagem
A primeira mensagem define a maior parte do resultado. A Skill preenche cada lacuna que você deixa com um palpite ou um texto provisório, então informe o produto, o público, os fatos principais e os arquivos de uma vez.
Específico e completo
- “
/launch-pageParcelo, rastreamento de encomendas para pequenas lojas online. Público: donos de loja. Três recursos: mapa ao vivo, alertas por SMS, devoluções. Logo: assets/logo.svg.”
Vago
- “Faça uma landing page.”
- A Skill precisa fazer perguntas ou preencher as lacunas com texto provisório.
Exemplos de Claude Skills: o que trazer para cada resultado
Cada tipo de resultado precisa de entradas diferentes. Passe por esta tabela antes de começar; tudo o que faltar na sua mensagem é algo que o agente vai inventar.
| Resultado | Traga |
|---|---|
| Imagens | Tema, estilo ou imagens de referência, tamanho ou proporção, e qualquer texto da imagem escrito exatamente como deve aparecer |
| Vídeo | Duração, proporção, roteiro ou pontos principais, gravações, logos e música |
| Páginas web | Textos reais e informações do produto, cores e logo da marca, e as seções de que você precisa |
| Slides | Anotações ou um documento de origem, quem é o público e uma quantidade aproximada de slides |

Confira o que ela realmente criou
Não julgue pelo resumo do agente. Abra os arquivos.
Uma mensagem de “pronto” pode parecer ótima enquanto um título transborda ou um link não leva a lugar nenhum. Estas verificações rápidas pegam a maioria dos problemas:
Imagens
Confira o tamanho e a proporção, e leia cada palavra da imagem letra por letra.
Vídeo
Assista até o fim e confirme que o texto na tela está legível.
Páginas web
Abra no navegador, reduza para a largura de celular e clique em todos os links.
Slides
Conte os slides, procure texto que transborda e confira os números com a sua fonte.
Consiga uma segunda versão melhor
Peça alterações no mesmo chat, onde o agente ainda tem os passos da Skill e as suas respostas anteriores. E seja preciso sobre o que muda e o que fica.
- Aponte o arquivo e o lugar: “Em
hero.png, aumente o título.” - Diga o que precisa ficar: “Mantenha o layout. Mude só as cores.”
- Peça uma alteração de cada vez, para ver o que cada uma fez.
- Se a primeira versão estiver muito longe, comece uma nova execução com entradas melhores. Remendar uma versão ruim leva mais tempo.
Quando algo dá errado
O agente ignora a Skill
Chame pelo nome. Se ainda assim ela não carregar, veja Solução de problemas.
Ela para no meio
Falta algo de que ela precisa. Instale o que a página da Skill lista em Dependências.
Ela pede uma API key
A Skill usa um serviço pago listado em Custos externos. Configure a chave do jeito que a documentação desse serviço descreve, nunca no chat.
O resultado não atende ao seu briefing
Entregue os dados ou arquivos que faltaram e peça para refazer só aquela parte.
Perguntas frequentes
Como uso Claude Skills?
Digite / e o nome da Skill no Claude Code e descreva o que você quer na mesma mensagem. Depois dessa primeira execução, pedidos comuns que combinam com a descrição da Skill a carregam automaticamente.
Preciso chamar uma Skill pelo nome toda vez?
Não. Chame pelo nome na primeira vez para confirmar que funciona; depois disso, descrever a tarefa costuma bastar. Se o agente escolher outra Skill, use o nome de novo.
Quais são alguns exemplos de Claude Skills?
Bons exemplos são Skills para trabalhos que você repete e quer com visual consistente, como landing pages de lançamento, apresentações de slides, capas e vídeos explicativos. Você pode explorar as Skills por tipo de resultado para ver mais.
Por que a Skill me entregou texto provisório?
Faltaram na sua mensagem informações de que ela precisava. Adicione os detalhes reais do produto, os textos e os arquivos e peça para refazer aquela parte.
Fontes
Este guia ajudou?
