Claude Code Skills: Crie fluxos de trabalho personalizados para seu assistente de programação de IA

Principais pontos

• As skills do Claude Code são arquivos Markdown que injetam regras de equipe, convenções e modelos de comando diretamente no contexto do agente.
• Uma skill pode ser tão simples quanto uma instrução de um parágrafo ou tão rica quanto um fluxo de trabalho de várias etapas com modelos, exemplos e referências a variáveis de ambiente.
• As skills substituem o antigo diretório de comandos personalizados e oferecem uma maneira unificada de ensinar o agente uma vez e reutilizar em várias sessões.
• Ao fixar uma skill em uma versão específica do modelo, os custos de token e a qualidade da saída tornam-se previsíveis; compare modelos no diretório de modelos da TokenLab e na página de preços da Anthropic antes de selecionar um para produção.

---

Entendendo as Skills do Claude Code

Skills são arquivos Markdown de texto simples que residem em .claude/skills/ dentro do seu projeto (ou globalmente em ~/.claude/skills/). Quando você invoca uma skill, o Claude Code injeta o conteúdo do arquivo diretamente no seu prompt de sistema, instruindo o agente a seguir essas diretrizes específicas primeiro.

Essa injeção significa que você controla o comportamento do agente com precisão. Um arquivo de skill pode listar padrões proibidos, bibliotecas obrigatórias, formatos de saída ou uma lista de verificação de arquitetura completa. Como as instruções são controladas por versão junto com seu código, cada membro da equipe recebe automaticamente o mesmo conjunto de diretrizes.

Cenários comuns que se beneficiam de uma skill dedicada incluem:

• Impor tipos TypeScript estritos em vez de objetos genéricos.
• Padronizar formatos de resposta de API.
• Automatizar a geração de migrações de banco de dados.
• Executar suítes de teste antes de realizar o commit do código.

Ao definir esses fluxos de trabalho como skills, você evita que o agente alucine comandos ou use bibliotecas obsoletas. Isso é particularmente útil ao trabalhar com modelos de codificação avançados. Se você está escolhendo entre diferentes LLMs para seu pipeline de desenvolvimento, pode ler nosso guia sobre os melhores modelos de IA para codificação em 2026 para ver como o Claude Sonnet 5 se compara a alternativas como o Kimi K2.7 Code ou o DeepSeek V4 Pro.

---

Como criar uma Skill personalizada

Criar uma skill é simples. Você escreve um arquivo Markdown, salva-o no diretório correto e, em seguida, faz referência a ele durante sua sessão do Claude Code. Vamos percorrer o processo de criação de uma skill que impõe uma arquitetura limpa e executa suítes de teste.

Primeiro, crie o diretório local na raiz do seu projeto:

mkdir -p .claude/skills

Em seguida, crie um arquivo chamado verify-and-test.md dentro desse diretório. Este arquivo instruirá o Claude Sonnet 5 a revisar a base de código, escrever um teste unitário usando Vitest e executar a suíte de testes para verificar as alterações.

# Skill de Verificação e Teste

Você é um engenheiro de software especialista. Sua tarefa é revisar as alterações no código, escrever um teste unitário abrangente e executar a suíte de testes.

## Instruções

1. Revisar Código: Analise os arquivos modificados. Certifique-se de que eles não usem APIs obsoletas.
2. Escrever Teste Unitário: Crie um arquivo de teste no diretório `tests/`. Use o Vitest.
3. Executar Testes: Execute `npm run test` para verificar se todos os testes passam.
4. Relatório: Forneça um resumo dos resultados dos testes e quaisquer problemas encontrados.

## Exemplos

Se o usuário pedir para você verificar uma nova função utilitária:
- Procure por `src/utils/math.ts`.
- Crie `tests/math.test.ts`.
- Execute `npm run test`.

Assim que você salvar este arquivo, o Claude Code o detectará automaticamente. Você pode invocá-lo pedindo ao agente para "executar a skill verify-and-test nas alterações mais recentes" ou referenciando o nome da skill diretamente no seu prompt.

Para entender como diferentes modelos lidam com esses fluxos de trabalho agenticos complexos e de várias etapas, você pode conferir nossa comparação do OpenRouter para avaliar a latência e a confiabilidade entre diferentes provedores de API.

---

Gerenciando custos de tokens e seleção de modelos

Ao executar o Claude Code, cada skill que você injeta aumenta sua contagem de tokens de entrada. Como as skills são anexadas ao prompt do sistema, arquivos de skill longos com exemplos extensos podem aumentar rapidamente sua fatura de API.

De acordo com a página de preços da Anthropic (observada em 07/07/2026), tokens de entrada e tokens de saída possuem estruturas de custo diferentes. Por exemplo, o Claude Sonnet 5 tem uma taxa específica por milhão de tokens de entrada e uma taxa mais alta por milhão de tokens de saída. Se você executar uma skill em cada prompt, esses tokens de entrada se acumulam.

Para manter seus custos de desenvolvimento gerenciáveis, considere estas estratégias:

• Mantenha as skills concisas: Evite adicionar bases de código massivas como exemplos dentro do arquivo da skill. Use trechos curtos e representativos.
• Use skills globais vs. locais: Mantenha regras específicas do projeto em .claude/skills/ e preferências gerais em ~/.claude/skills/ para evitar sobrecarregar seu contexto.
• Compare modelos alternativos: Embora o Claude Sonnet 5 seja excelente para tarefas de codificação complexas, você pode querer direcionar tarefas mais simples para modelos de menor custo. Você pode revisar o guia de comparação de preços para ver como diferentes provedores precificam seus tokens de entrada e saída.

---

Melhores práticas para Skills do Claude Code

Para aproveitar ao máximo seus fluxos de trabalho personalizados, siga estas diretrizes práticas.

Prática	Descrição	Benefício
Controle de Versão	Faça commit de .claude/skills/ no seu repositório Git.	Garante que toda a equipe use os mesmos padrões de codificação.
Definir Entradas	Especifique quais variáveis ou arquivos a skill espera.	Reduz a ambiguidade e evita que o agente adivinhe.
Fornecer Exemplos Negativos	Inclua seções de "O que não fazer" no seu Markdown.	Impede que o modelo repita erros comuns do passado.
Testar Alterações Incrementais	Execute a skill em pequenas alterações de código primeiro.	Torna a depuração das instruções da skill muito mais fácil.

Ao escrever skills, trate-as como código. Se uma skill falhar em produzir a saída desejada, refine o prompt, adicione exemplos mais claros ou restrinja o escopo das instruções. Se o seu fluxo de trabalho exigir a geração de ativos além de código, como mockups de UI ou mídia promocional, você pode explorar as melhores APIs de modelos de imagem de IA em 2026 ou as melhores APIs de modelos de vídeo de IA em 2026 para encontrar as APIs certas para essas tarefas.

---

Perguntas Frequentes

Onde devo armazenar minhas skills do Claude Code?

Você pode armazená-las localmente na raiz do seu projeto em .claude/skills/ para regras específicas do projeto, ou globalmente em ~/.claude/skills/ para regras que você deseja aplicar em todos os seus projetos na sua máquina.

Posso usar outros modelos com o Claude Code?

O Claude Code foi projetado pela Anthropic principalmente para seus próprios modelos, como o Claude Sonnet 5. No entanto, você pode comparar as capacidades e preços de vários modelos no diretório de modelos da TokenLab para ver como eles se saem em benchmarks de codificação.

Como desativo uma skill durante uma sessão?

Se você não quiser que o Claude Code use uma skill específica, você pode mover o arquivo Markdown para fora do diretório .claude/skills/ ou renomear a extensão do arquivo para que o agente não o reconheça como uma skill ativa.

---

Comece com a TokenLab

Pronto para otimizar seu fluxo de trabalho de desenvolvimento com IA? Encontrar o modelo certo com a melhor relação custo-benefício é fundamental para escalar suas aplicações. Explore a Categoria de Modelos de Código da TokenLab para comparar os modelos mais recentes, analisar preços de tokens e encontrar a LLM perfeita para seus agentes de codificação.