Como criar um Skill do Claude (passo a passo, com um modelo gratuito)

10 min de leitura KissMySkills

Para criar uma skill do Claude, você escreve uma pasta com um arquivo dentro dela: um SKILL.md que começa com um nome e uma descrição, seguidos de instruções em linguagem simples. Compacte a pasta, faça upload dela no Claude (ou coloque-a em ~/.claude/skills/ para o Claude Code), e o Claude a carregará sempre que uma solicitação corresponder à descrição. Sem código, sem SDK, sem etapa de compilação.

Nesta página
  1. O que você precisa antes de começar
  2. Etapa 1: escolha um trabalho e defina o que significa "concluído"
  3. Etapa 2: crie a pasta e o arquivo SKILL.md
  4. Etapa 3: Escreva o frontmatter (a parte que decide quando ele é acionado)
  5. Etapa 4: Escreva as instruções como um método, não como um estado de espírito
  6. Etapa 5: Adicione um exemplo de saída concluída
  7. Etapa 6: Empacote e instale
  8. Etapa 7: Teste como você realmente faria
  9. Modelo gratuito de Skill do Claude (copie e adapte)
  10. Cinco erros que tornam uma Skill inútil
  11. Deixe Claude escrever o primeiro rascunho para você
  12. Criar o seu ou começar com um pronto?

Esse é todo o mecanismo. O que diferencia uma skill que é acionada sempre e produz um trabalho pronto para envio de outra que nunca é acionada são cerca de seis decisões, e este guia apresenta cada uma em ordem. No final, há um modelo gratuito que você pode copiar e uma checklist para testar sua skill antes de depender dela.

Se a ideia for nova para você, comece por O que são as Skills do Claude? e volte aqui. Esta página pressupõe que você sabe o que é uma skill e quer criar uma.

O que você precisa antes de começar

  • Uma conta Claude com a execução de código ativada. As skills funcionam nos planos Free, Pro, Max, Team e Enterprise, mas a configuração de execução de código e criação de arquivos precisa estar ativada. Nos planos Team e Enterprise, talvez um administrador precise ativar as skills para a organização primeiro.
  • Um editor de texto. Qualquer ferramenta que salve texto simples: VS Code, TextEdit no modo de texto simples, Notepad.
  • Uma tarefa repetível. Não "marketing". Algo como "transformar a transcrição de uma ligação de vendas em uma anotação de CRM no nosso formato" ou "revisar um contrato em busca dos nossos cinco sinais de alerta padrão". Quanto mais específico o trabalho, melhor a skill.
  • Dois ou três exemplos reais de bons resultados. Relatórios, e-mails e briefings anteriores que você teria prazer em enviar. Este é o melhor material bruto para uma skill.

Etapa 1: escolha um trabalho e defina o que significa "concluído"

A maioria das skills malsucedidas falha aqui, antes que uma linha seja escrita. Uma skill que tenta abranger "tudo o que um gerente de marketing faz" acaba com uma descrição vaga, é acionada nos momentos errados e fornece respostas genéricas quando é acionada.

Escreva duas frases antes de qualquer outra coisa:

  1. O acionador: "Use isto quando alguém pedir X ou enviar Y."
  2. O resultado: "O resultado é um Z com estas seções, neste tamanho e neste tom."

Exemplo: "Use isto quando alguém colar a transcrição de uma ligação com um cliente e pedir anotações. O resultado é uma anotação de CRM com Resumo, Pontos problemáticos, Orçamento, Próximo passo e Risco, com menos de 200 palavras, escrita para um gerente de vendas que não participou da ligação." Se você não conseguir escrever essas duas frases, divida o trabalho em duas skills.

Etapa 2: crie a pasta e o arquivo SKILL.md

Uma skill é uma pasta cujo nome corresponde ao nome da skill. Dentro dela, o único arquivo obrigatório é SKILL.md (o nome do arquivo diferencia maiúsculas de minúsculas). Extras opcionais ficam ao lado dele:

Caminho Obrigatório? Para que serve
call-notes/SKILL.md Sim Frontmatter mais as instruções que Claude segue
call-notes/resources/example-output.md Recomendado Um exemplo concluído do material a ser entregue
call-notes/resources/style-guide.md Opcional Material de referência mais longo que Claude lê somente quando necessário
call-notes/scripts/ Opcional Scripts de Python ou shell para etapas que precisam ser exatas, como analisar um CSV

Mantenha o nome da pasta em minúsculas e com hífens, como call-notes ou quarterly-report. A mesma string vai em nome campo na próxima etapa.

Etapa 3: Escreva o frontmatter (a parte que decide quando ele é acionado)

O arquivo começa com um pequeno bloco YAML entre duas linhas com três hífens. Dois campos são obrigatórios:

  • name - letras minúsculas, números e hífens, com até 64 caracteres. Torna-se o identificador e, no Claude Code, o comando de barra (/call-notes).
  • description - até 1.024 caracteres. Esta é a única parte que Claude lê para cada habilidade instalada no início de uma sessão. Ela decide se sua habilidade será carregada.

Escreva a descrição como você explicaria a um colega que precisa decidir em um segundo se uma solicitação é responsabilidade dele. Comece pelo que a habilidade produz e, em seguida, liste as situações e frases que devem acioná-la. Compare:

  • Fraco: "Ajuda com notas de vendas."
  • Forte: "Transforma a transcrição de uma ligação de vendas ou descoberta em uma nota estruturada de CRM (Resumo, Pontos problemáticos, Orçamento, Próximo passo, Risco) com menos de 200 palavras. Use quando o usuário colar uma transcrição de ligação, o texto de uma gravação de reunião ou anotações brutas de uma ligação e pedir notas, um resumo, uma entrada de CRM ou um resumo de acompanhamento."

A versão mais forte nomeia a entrada, a saída e as palavras que as pessoas realmente digitam. É isso que faz a habilidade ser acionada de forma confiável e permanecer silenciosa no restante do tempo.

Etapa 4: Escreva as instruções como um método, não como um estado de espírito

Tudo abaixo do frontmatter é Markdown que Claude segue assim que a habilidade é carregada. O erro comum é uma persona longa ("Você é um especialista em vendas de classe mundial com 20 anos...") sem procedimento. Claude não precisa de uma história de fundo. Precisa de etapas, regras e um formato-alvo. Uma estrutura que funciona para a maioria das habilidades empresariais:

  1. Entradas - o que o usuário fornecerá e o que perguntar se estiver faltando (no máximo duas perguntas; depois, prossiga com as suposições declaradas).
  2. Fluxo de trabalho - etapas numeradas na ordem em que um profissional cuidadoso as seguiria.
  3. Formato de saída - as seções, os títulos, o tamanho e o tom exatos.
  4. Regras - as coisas que sempre devem ou nunca devem acontecer ("nunca invente um valor de orçamento; escreva 'não discutido'").
  5. Verificação de qualidade - uma lista breve que Claude percorre antes de responder.

Procure fazer algo que caiba em uma ou duas telas. Se o arquivo passar de aproximadamente 500 linhas, mova o material de referência (guias de estilo extensos, listas de preços, textos de políticas) para arquivos em resources/ e diga ao Claude em SKILL.md quando abri-los. O Claude carrega esses arquivos extras somente quando a tarefa precisa deles, mantendo o contexto enxuto. Para saber mais sobre a estrutura do arquivo, consulte O que é um arquivo SKILL.md?

Etapa 5: Adicione um exemplo de saída concluída

Um exemplo ensina o formato mais rapidamente do que qualquer quantidade de descrição. Inclua um entregável realista e concluído em resources/example-output.md e faça referência a ele no fluxo de trabalho ("corresponda à estrutura e ao tamanho de resources/example-output.md"). Use um trabalho anterior real, com nomes e números alterados, não um placeholder cheio de colchetes. Nosso próprio catálogo segue a mesma regra: todo Skill é lançado com um exemplo de saída, porque esse é o sinal mais claro de que alguém realmente testou o recurso.

Etapa 6: Empacote e instale

No Claude (web e desktop): compacte a pasta em um arquivo zip para que a própria pasta fique na raiz do zip (call-notes.zip contendo call-notes/SKILL.md). Abra a seção de Skills nas configurações, carregue o arquivo zip e ative o Skill. Inicie uma nova conversa e faça uma solicitação que corresponda à descrição.

No Claude Code: não é necessário usar um arquivo zip. Coloque a pasta em ~/.claude/skills/ para usá-la em todos os projetos ou em .claude/skills/ dentro de um repositório para compartilhá-la com todas as pessoas que trabalham nesse repositório. Digite /call-notes ou simplesmente descreva a tarefa. O Claude Code detecta as alterações na pasta sem reinicialização.

O passo a passo completo para cada superfície, incluindo onde os arquivos ficam e o que fazer quando um upload é rejeitado, está em Como instalar um Skill do Claude. Desenvolvedores que trabalham principalmente no terminal também devem ler Skills do Claude Code.

Etapa 7: Teste como você realmente faria

Um Skill que só foi testado uma vez não foi testado de verdade. Faça esta verificação antes de compartilhá-lo com uma equipe:

  1. Teste de ativação (5 prompts). Escreva cinco solicitações que devem ativar o Skill, formuladas de maneiras diferentes. Conte quantas ativam. Menos de quatro significa que a descrição precisa incluir mais palavras usadas realmente pelo usuário.
  2. Teste de silêncio (5 prompts). Escreva cinco solicitações relacionadas que não devem ativá-lo. Se ele for ativado em alguma delas, restrinja a descrição.
  3. Teste de entradas ausentes. Dê a ele metade das entradas. Ele deve fazer uma pergunta curta ou declarar suas suposições, não inventar fatos.
  4. Teste de formato. Compare três saídas lado a lado com seu exemplo. As mesmas seções, a mesma faixa de tamanho, o mesmo tom?
  5. Teste de casos extremos. Forneça a entrada real mais confusa que você tiver: uma transcrição desconexa, uma planilha parcialmente vazia.

Corrija a descrição para resolver problemas de acionamento e o fluxo de trabalho ou as regras para resolver problemas de saída. Mantenha um registro de alterações curto no final do arquivo para saber qual versão sua equipe está usando.

Modelo gratuito de Skill do Claude (copie e adapte)

Substitua as partes em letras maiúsculas, exclua o que não precisar e salve como SKILL.md dentro de uma pasta com o mesmo nome que o nome campo.

---
name: seu-nome-de-skill
description: Produz UM ENTREGÁVEL ESPECÍFICO (seções, tamanho) a partir de UMA ENTRADA ESPECÍFICA. Use quando o usuário PEDIR X, COLAR Y ou mencionar Z. Não use para UMA TAREFA PRÓXIMA QUE PERTENÇA A OUTRO LUGAR.
---

# TÍTULO DA SUA SKILL

## Objetivo
Uma ou duas frases: para quem isso é e como é o resultado "concluído".

## Entradas
- Obrigatório: O QUE O USUÁRIO DEVE FORNECER
- Opcional: O QUE MELHORA O RESULTADO
- Se faltar uma entrada obrigatória, faça no máximo duas perguntas curtas,
  depois prossiga e liste suas suposições no início da saída.

## Fluxo de trabalho
1. Leia a entrada e identifique os ELEMENTOS-CHAVE.
2. Confira-a em relação às REGRAS OU AOS CRITÉRIOS.
3. Rascunhe a saída no formato abaixo.
4. Faça a verificação de qualidade, corrija tudo o que falhar e depois responda.

## Formato de saída
- Seção 1: NOME - O QUE VAI AQUI (tamanho)
- Seção 2: NOME - O QUE VAI AQUI (tamanho)
- Seção 3: NOME - O QUE VAI AQUI (tamanho)
Siga a estrutura e o tamanho de resources/example-output.md.

## Regras
- Nunca invente números, nomes ou datas. Escreva "não fornecido" em vez disso.
- Use linguagem simples. Sem introduções vazias.
- REGRA ESPECÍFICA DA SUA EQUIPE OU DO SEU SETOR.

## Verificação de qualidade
- Todas as seções estão presentes e na ordem?
- Toda afirmação pode ser rastreada até a entrada?
- Está dentro do limite de tamanho?

## Registro de alterações
- v1.0 PRIMEIRA VERSÃO, DATA

Quer ver como são as Skills prontas? Exemplos de Skills do Claude apresenta doze arquivos SKILL.md reais linha por linha, sendo a maneira mais rápida de calibrar quanto detalhe é suficiente.

Cinco erros que tornam uma Skill inútil

  • Uma descrição que diga o que a Skill é, não quando usá-la. "Um redator especializado" nunca é acionado. "Escreve textos para páginas de produtos a partir de uma lista de recursos quando o usuário pede uma descrição de produto, texto de PDP ou texto de anúncio" é.
  • Uma Skill para um departamento inteiro. Orçamento, folha de pagamento e auditoria em um único arquivo dão três meias-respostas. Crie três Skills.
  • Nenhum formato de saída. Sem um, cada execução fica diferente e ninguém confia nela.
  • Segredos no arquivo. Nunca cole chaves de API, senhas ou dados de clientes em um Skill. Qualquer pessoa com quem você o compartilhar poderá lê-lo.
  • Instalar o Skill de outra pessoa sem lê-lo. Um Skill contém instruções que Claude seguirá, às vezes com scripts. Leia-o como você leria um script antes de executá-lo.

Deixe Claude escrever o primeiro rascunho para você

Você não precisa começar com um arquivo em branco. Claude pode entrevistar você sobre a tarefa, elaborar o frontmatter e o fluxo de trabalho, gerar um exemplo de saída e propor os prompts de teste acima. A Anthropic oferece um Skill skill-creator integrado exatamente para isso, e você também pode pedir em linguagem simples: "Entreviste-me sobre como escrevo nosso relatório semanal para clientes e depois escreva um SKILL.md para isso." O rascunho precisará das suas edições, especialmente na descrição e nas regras, mas elimina a maior parte da digitação.

Prefere um formulário a um chat? O Claude Skill Builder gratuito transforma uma breve descrição da tarefa em um SKILL.md pronto, com frontmatter e um fluxo de trabalho, que você pode copiar ou baixar como um .zip para Claude.ai e Claude Code. Sem cadastro.

Quer que a entrevista, o autoteste e o empacotamento sejam feitos para você? O Claude Skill Creator (US$ 19) é um Skill que cria Skills: ele pergunta sobre o trabalho, as solicitações que as pessoas realmente digitam e o que nunca deve acontecer, escreve uma pasta completa do Skill com o SKILL.md e um exemplo de saída, testa a descrição com solicitações que devem e não devem ativá-lo e empacota a pasta para Claude, Claude Code e a API. Para auditar um Skill que você escreveu ou baixou, use o Claude Skill Reviewer & Security Linter ou adquira ambos, além de Skills de revisão de prompts, MCP e código, no Build Your Own Claude Skills Kit (US$ 49).

Criar o seu ou começar com um pronto?

Crie o seu quando o fluxo de trabalho for exclusivo da sua equipe, quando ele codificar conhecimento interno que ninguém de fora possui ou quando você gostar de iterar. Comece com um Skill pronto quando o trabalho for de uma função padrão (contabilidade, briefings de SEO, revisão de contratos, respostas de suporte) e você preferir passar a tarde trabalhando em vez de escrevendo instruções. Um Skill pronto da nossa biblioteca de Skills do Claude custa US$ 19, vem com um exemplo de saída e é um arquivo Markdown simples que você pode abrir e editar, portanto também funciona como um modelo inicial para sua própria versão.

De qualquer forma, o próximo passo é o mesmo: escolha uma tarefa que você repete toda semana, escreva as duas frases da Etapa 1 e tenha um Skill funcionando antes do fim do dia.

Perguntas frequentes

Do I need to know how to code to create a Claude skill?+

No. A skill is a Markdown file with a short header containing a name and a description, followed by instructions in plain language. Scripts are optional and only needed when a step must be computed exactly, such as parsing a file.

What is the minimum a Claude skill needs?+

One folder containing a file named SKILL.md. The file must start with YAML frontmatter that has a name (lowercase letters, numbers and hyphens) and a description of up to 1,024 characters. Everything after that is your instructions.

Why does my Claude skill never trigger?+

Almost always because of the description. Claude reads only the name and description of each installed skill to decide whether to load it. Rewrite the description to lead with the deliverable and include the exact words people use when they ask for that task.

How do I install a skill I created?+

In Claude on the web or desktop, zip the skill folder and upload it in the skills section of your settings, then switch it on. In Claude Code, place the folder in ~/.claude/skills/ for all projects or .claude/skills/ inside a repository. Code execution must be enabled on your account.

Can Claude write a skill for me?+

Yes. Anthropic provides a built-in skill-creator skill, and you can also ask Claude to interview you about a task and draft the SKILL.md. Treat the draft as a starting point and edit the description, rules and example output yourself before relying on it.