"Estou preocupado se consigo usar IA porque tenho conhecimento zero em programação..."
"Tenho medo de olhar para aquela tela preta do terminal e não sinto vontade."
"Mas estou ansioso por ficar para trás na tendência da IA 😱"
Mesmo nesse estado, ao deixar o Claude Code aprender meus "próprios padrões de ação", uma tarefa que costumava levar 30 minutos toda vez agora leva 5 minutos.
Na verdade, a oportunidade está chegando justamente para quem não é engenheiro.
O segredo são as Skills.
Em termos de Pokémon, é uma "Máquina Técnica" (MT).
Ao usar o Claude Code, você já se sentiu assim?
- Ele é inteligente, com certeza. Mas toda vez, tenho que configurar o formato, os critérios de julgamento e as informações de contexto.
- Mesmo sendo IA, tem muito trabalho manual. "Não é a mesma coisa que fazer tudo sozinho?"
- Será que outras pessoas estão usando de forma mais eficaz?
- Estou usando, mas não dominando. Não sei qual é a diferença.
Ao terminar de ler este artigo, você será capaz de criar um ambiente onde você só configura seu fluxo de trabalho na IA uma vez, e a mesma saída de qualidade sai toda vez.
Santiago (@santtiagom_), engenheiro do MercadoLibre, a maior empresa de e-commerce da América do Sul, publicou um guia completo sobre Skills em espanhol que está viralizando com mais de 580.000 visualizações.
Ele diz que criou mais de 50 Skills e deletou a maioria em dois dias. Este guia é baseado na experiência real dele do que restou e mudou completamente a forma como ele trabalha com Claude.
Tenho dois pedidos antes de começar.
- Salve este artigo e reserve 20 minutos esta semana.
- Se você conhece alguém que usa Claude Code, compartilhe com essa pessoa.
Desta vez, vou explicar o conteúdo de uma forma fácil de entender.
Aqui está o post original.
https://x.com/santtiagom_/status/2030305647535751338
Por que o Claude Precisa de Configuração Toda Vez
Primeiro, deixe-me falar sobre a premissa principal.
O Claude Code é muito inteligente. No entanto, ele não conhece "seu jeito de trabalhar".
Isso não é um problema de desempenho, mas uma questão de como ele funciona.
O Claude começa do zero toda vez que você abre uma nova sessão. A menos que você diga a ele toda vez, o Claude não sabe qual formato você prefere, que tipo de relatório seu chefe quer, ou qual tom você usa em e-mails para clientes. Esses são "seus critérios de julgamento únicos".
Esse mecanismo causa três problemas.
Problema 1: Falta de Consistência
Mesmo com o mesmo pedido de "criar um relatório semanal", hoje pode ser uma versão detalhada de 2.000 caracteres, e amanhã podem ser três tópicos. Como seu formato desejado não está definido, o Claude tem que decidir sozinho toda vez.
Problema 2: Seus Critérios de Julgamento Únicos Estão Faltando
O Claude é excelente em geral. Mas ele não conhece regras que só se aplicam no seu ambiente, como "na sua empresa, você deve começar com a conclusão" ou "seu chefe não lê documentos com mais de 3 páginas".
Então, toda vez, você precisa configurar esse contexto do zero.
Problema 3: O Esforço da Configuração se Acumula
Digitar especificações de formato, explicar critérios de julgamento e compartilhar informações de contexto.
Quanto tempo você gasta nessa "configuração" em um dia? Mesmo usando IA, você se cansa só com a preparação.
santtiagom_ escreve:
"E se você pudesse escrever uma instrução uma vez e ela ficasse perfeita a partir de então, sem precisar dar instruções novamente? É para isso que servem as Skills."
Skills é um mecanismo onde você escreve seu fluxo de trabalho em um único arquivo e o configura no Claude. Uma vez configurado, o Claude agirá de acordo com ele da próxima vez, sem que você diga nada.
A partir daqui, vou explicar o panorama geral das Skills em ordem.
Skills são as "Máquinas Técnicas" do Claude
Você já usou uma "Máquina Técnica" (MT) em Pokémon?
Apenas carregando um disco, aquele Pokémon aprende um novo movimento. Uma vez aprendido, o movimento pode ser usado quantas vezes você quiser em todas as batalhas. Para sempre, a menos que você o faça esquecer.
Skills são exatamente como essas "Máquinas Técnicas".
Você cria um arquivo chamado SKILL.md e o configura no Claude.
Então, o Claude agirá de acordo com essas instruções toda vez que abrir uma sessão. Você não precisa mais configurar coisas toda vez.
Para organizar a correspondência de forma simples:
- Uma MT → Um arquivo SKILL.md
- Um Pokémon que aprendeu um movimento o usa em todas as batalhas → O Claude com uma Skill configurada a aplica em todas as sessões
- Substituível (pode reaprender) → Skills também podem ser adicionadas/deletadas/substituídas livremente
- Existe compatibilidade (alguns movimentos não podem ser aprendidos) → Algumas Skills não se encaixam no projeto
O importante é que seu trabalho também tem "tarefas que podem ser transformadas em MTs".
Por exemplo, ao fazer um relatório:
"Escreva a conclusão primeiro. Use no máximo 3 pontos de dados. Use um formato que o chefe possa julgar em 5 segundos."
Se você definir isso como uma Skill, o Claude seguirá automaticamente esta regra da próxima vez.
Ao fazer um relatório semanal:
"Três partes: Resultados da semana passada → Planos desta semana → Problemas.
Escreva os números como uma comparação semana a semana." Você também pode definir isso como uma Skill.
Ao escrever um e-mail para um cliente:
"Expresse gratidão no início. Mantenha o ponto principal em até 3 linhas. Indique claramente apenas uma próxima ação." Isso também.
Vamos comparar um mundo com Skills e um mundo sem elas.
[Sem Skills]
Você pede para "criar um relatório semanal" → Claude gera no seu próprio formato → Você corrige: "Não, conclusão primeiro", "Limite os dados a 3 pontos" → Na semana seguinte, você começa do zero digitando tudo novamente.
[Com Skills]
Você pede para "criar um relatório semanal" → Claude gera de acordo com as Skills → Desde o início, está no formato "Conclusão → 3 Pontos de Dados → Problemas" → Correções são quase zero.
santtiagom_ enfatiza repetidamente esta forma de pensar em seu artigo:
"Uma Skill funcional de 5 linhas é mais valiosa do que uma Skill perfeita com 80 regras."
Você não precisa criar instruções perfeitas. Mesmo apenas duas linhas como "Escreva a partir da conclusão. Até 3 pontos de dados" serão eficazes se definidas como uma Skill.
E esta é a parte que eu pessoalmente mais quero transmitir.
A essência das Skills não é "automação do trabalho".
É o "ato de verbalizar seus critérios de julgamento e configurá-los na IA."
"Escreva a partir da conclusão", "Limite os dados a 3 pontos". Esses não são procedimentos de trabalho, mas seus critérios de julgamento. Qual informação priorizar, em que ordem transmiti-la e com que nível de detalhe escrever.
Você deixa esses julgamentos em um arquivo. Assim como um movimento aprendido de uma MT se torna a força de um Pokémon, critérios de julgamento verbalizados se tornam a força do Claude.
Transformação de julgamento em ativo. Se eu fosse descrever Skills em uma palavra, seria isso.
Tudo que Você Precisa é de Um Arquivo: SKILL.md
O mecanismo das Skills é muito mais simples do que você imagina.
Tudo que você precisa é de um arquivo chamado SKILL.md.
O conteúdo deste arquivo é dividido em duas partes.
Parte 1: A "Capa" com Nome e Descrição
No topo do arquivo, você escreve o nome da Skill e uma descrição de "quando ela deve ser usada".
O Claude olha para esta "capa" e julga "se deve usar esta Skill para a tarefa atual". Se isso for ambíguo, o Claude não encontrará a Skill que você se esforçou para criar.
Por exemplo, apenas com o nome "Criação de Relatório", o Claude vai pensar "Qual relatório? Quando eu uso?"
Se você escrever "Criar relatório de vendas semanal para o Gerente Tanaka. Estrutura: Conclusão → Números → Problemas", o Claude selecionará automaticamente esta Skill no momento em que um pedido de relatório semanal chegar.
Em termos de MT, esta capa corresponde ao julgamento de "qual Pokémon pode aprender este movimento".
Parte 2: O "Corpo" com Instruções Específicas
Esta é a sua forma real de trabalhar.
Você escreve procedimentos e regras específicas como "Escreva nesta ordem", "Siga este formato" e "Verifique apenas este ponto".
As Skills funcionam com apenas essas duas partes.
É mais rápido olhar para um arquivo real, então aqui está um exemplo. Ele assume uma situação onde uma equipe de vendas envia um relatório semanal para o chefe toda semana.
1---2name: Relatório de Vendas Semanal3description: Use ao criar o relatório semanal para a equipe de vendas toda segunda-feira. Para o Gerente Tanaka.4---56# Relatório de Vendas Semanal78## Formato9- Escreva a conclusão (previsão de chegada para esta semana) na primeira página10- Sempre inclua números como uma comparação semana a semana (ex: +12% vs semana passada)11- Classifique os negócios em três níveis: A/B/C12- Limite os problemas a um, e adicione uma ação específica de uma linha para a próxima semana1314## Regras do Gerente Tanaka15- Ele não lê mais de 3 páginas. Mantenha em até 2 páginas16- Ele prefere tabelas a gráficos17- Não escreva "em análise". Sempre converta para "o que será feito até quando"
Este é o panorama geral do SKILL.md.
Olhando para a descrição na "capa" dizendo "toda segunda-feira... para o Gerente Tanaka", o Claude julga automaticamente: "Ah, isso é sobre o relatório semanal."
Então, seguindo as instruções no "corpo", ele cria um relatório de 2 páginas ou menos começando com a conclusão no mesmo formato toda vez.
Regras como "Regras do Gerente Tanaka", que só se aplicam no seu local de trabalho, são o verdadeiro valor das Skills. Por mais inteligente que o Claude seja, ele não saberá as preferências do Gerente Tanaka a menos que você ensine.
Existem duas maneiras de ativar.
A primeira é chamá-lo diretamente você mesmo, como "/criar-relatorio". Use isso quando quiser garantir que ele seja ativado.
A segunda é o Claude ler a descrição da capa e julgar automaticamente que "isso deve ser usado agora". Se a descrição estiver bem escrita, ele será ativado sozinho, sem que você dê nenhuma instrução.
Se se tornar uma Skill maior, você pode adicionar pastas auxiliares para materiais de referência e modelos, mas um SKILL.md é suficiente no começo.
O Claude Não Fica Mais Lento Mesmo com 50 Skills
"Se eu colocar muitas Skills, o movimento do Claude não vai ficar mais lento?"
Acho que esta é uma pergunta que todos têm no início.
A resposta é: não vai ficar mais lento.
O Claude não carrega todas as Skills de uma vez; ele é projetado para carregar apenas o necessário em etapas.
Em termos de MT, um Pokémon não está pensando em todos os seus movimentos o tempo todo. Ele escolhe o movimento a ser usado com base na situação da batalha. O Claude é igual.
Nível 1: Primeiro, dê uma olhada nos nomes
Ele primeiro verifica levemente apenas o "nome e descrição" de todas as Skills. Ainda não leu o conteúdo dos arquivos.
Nível 2: Leia o texto completo apenas do que é necessário
Se ele encontrar uma Skill que parece relacionada à solicitação atual, ele lê o texto completo apenas daquela Skill. Ele não toca no resto.
Nível 3: Leia materiais relacionados adicionais, se necessário
Se a Skill especificar "por favor, leia também este material de referência", ele lê esse arquivo também.
Em outras palavras, mesmo que haja 50 Skills, apenas as "1 ou 2 relacionadas ao trabalho atual" são realmente carregadas. Isso quase não tem impacto no desempenho.
No entanto, há uma coisa a ser observada.
Se a "descrição" na capa for malfeita, o Claude não conseguirá encontrar a Skill necessária.
No Nível 1, pode ser mal interpretado como "isso não parece relevante desta vez" e ser pulado.
É por isso que eu disse que a descrição da capa é a mais importante. É vital escrever claramente "quando e para que tipo de tarefa esta Skill deve ser usada".
Como guia prático, não há problema algum enquanto o total de todos os nomes e descrições das Skills estiver dentro de 15.000 caracteres. É improvável que você atinja esse limite com uso normal.
Sua Primeira Skill é Concluída em 6 Passos
Agora, a parte prática.
Vou detalhar os "6 passos para criar sua primeira Skill" introduzidos por santtiagom_.
No entanto, primeiro identifique o momento de criar uma Skill. Se pelo menos uma das três condições a seguir se aplicar, é hora de uma Skill:
- Há informações de contexto que você está digitando manualmente (formato, regras, tom, etc.)
- Há uma tarefa que você quer que seja produzida com a mesma qualidade toda vez
- Há um passo que você sempre esquece
Por outro lado, Skills não são adequadas para tarefas únicas ou trabalhos onde as condições são completamente diferentes toda vez.
Vamos ver os 6 passos em ordem.
1️⃣ As sementes das Skills estão na repetição
"Se você digitou as mesmas informações de contexto 3 vezes ou mais, é um candidato a Skill."
santtiagom_ afirma isso.
Formatos de ata de reunião, regras de estrutura de relatório, tons de e-mail. Se há informações de contexto que você digita toda vez, esse é um sinal de que devem ser configuradas em uma Skill.
Começando hoje por uma semana, tente anotar o que você digita manualmente no Claude. Você encontrará coisas que repete 3 vezes ou mais.
2️⃣ Prepare-se com uma pasta e um arquivo
Crie uma pasta chamada .claude/skills/ dentro do seu projeto Claude Code, crie uma pasta com o nome da Skill dentro dela e coloque o arquivo SKILL.md lá.
1.claude/skills/2 └── relatorio-semanal/3 └── SKILL.md
Isso é tudo que você precisa para se preparar.
3️⃣ 5 linhas são suficientes no começo
Lembre-se das palavras de santtiagom_: "Uma Skill funcional de 5 linhas é mais valiosa do que uma Skill perfeita com 80 regras."
Não miro na perfeição desde o início.
Mesmo para o exemplo do relatório semanal anterior, isso é suficiente no começo:
1---2name: Relatório de Vendas Semanal3description: Use ao criar o relatório semanal para a equipe de vendas toda segunda-feira4---56Escreva a conclusão primeiro. Números são comparação semana a semana. Limite os problemas a um. Dentro de 2 páginas.
Pronto. O corpo tem apenas uma linha.
Que tal? Se for só isso, você poderia fazer isso a partir de hoje, certo?
Enquanto usa, se você notar "O Gerente Tanaka prefere tabelas a gráficos" ou "Se eu escrever 'em análise', ele devolve", você pode simplesmente adicionar essas coisas cada vez.
A versão finalizada de antes é o resultado de cultivá-la assim.
4️⃣ O efeito é claro com testes de comparação
Tente a mesma solicitação tanto com a Skill ativada quanto com ela desativada.
Se houver uma diferença clara na saída, é prova de que a Skill está funcionando.
Se não houver diferença, o conteúdo da Skill pode conter apenas coisas "que o Claude já sabe". Tente adicionar critérios de julgamento que só você conhece.
5️⃣ Skills crescem toda vez que falham
Se você sentir "esta parte ainda está errada" após o teste, adicione isso ao SKILL.md cada vez.
Para usar as palavras de santtiagom_, "Se você fez a mesma correção 3 vezes, adicione-a à Skill."
Uma Skill perfeita não é algo que você faz desde o início; é algo que você cultiva enquanto usa. Este processo de "aprender com o fracasso e crescer" é o ato de tornar seus critérios de julgamento cada vez mais precisos.
6️⃣ O próprio Claude dará sugestões de melhoria
Esta é a parte interessante.
Usando a Skill skill-creator fornecida oficialmente pela Anthropic, o próprio Claude sugerirá coisas como "Que tal fazer isso para tornar esta Skill ainda melhor?"
Depois de definir seu fluxo de trabalho na IA, a IA então retorna com "Seria mais eficiente fazer desta forma." Este ciclo é a diversão e a força das Skills.
3 Sinais de Alerta para Cultivar Skills Úteis
Depois de criar uma Skill, você precisa verificar se ela está funcionando corretamente.
santtiagom_ lista apenas um método de julgamento.
Se você executar a mesma tarefa 3 vezes e obtiver resultados diferentes toda vez, essa Skill precisa de melhoria.
Especificamente, fique atento a estes três sinais de alerta:
Sinal de Alerta 1: Instruções são ignoradas
Isso acontece quando a redação da Skill é ambígua.
Por exemplo, mesmo se você especificar "escreva claramente", os critérios para "claro" não são claros para o Claude. Neste caso, o Claude não tem escolha a não ser escrever com base em seu próprio julgamento.
"Escreva a conclusão primeiro. Mantenha uma frase dentro de 40 caracteres. Não use termos técnicos."
Se você escrever especificamente a este ponto, o Claude não hesitará. O truque é escrever com números e regras específicas em vez de adjetivos ambíguos.
Sinal de Alerta 2: Skill não ativa
Este é um caso onde há um problema com a descrição da "capa".
Lembre-se da conversa sobre carregamento em etapas de antes. O Claude julga olhando apenas para o "nome e descrição" no Nível 1. Se a descrição aqui for ambígua, será pulada como "não parece relevante desta vez".
Verifique se a descrição deixa claro à primeira vista "quando e para que tarefa deve ser usada".
Sinal de Alerta 3: Saída é genérica, sem diferença com/sem Skill
Este é um estado onde o conteúdo escrito na Skill é apenas coisas "que o Claude já sabe".
O Claude é inteligente, então ele pode julgar coisas gerais sozinho sem ser ensinado. A maneira correta é escrever critérios de julgamento que só você conhece nas Skills.
"O chefe lê a partir da conclusão", "Ele pula dados se exceder 3 pontos", "Ele fica bravo se não for escrito como uma comparação semana a semana". Essas regras, necessárias precisamente por causa do seu ambiente, determinam o valor de uma Skill.
Das melhores práticas de santtiagom_, selecionei 4 pontos particularmente importantes para introduzir.
① Claude é inteligente. Não precisa ensinar o que ele já sabe.
Instruções gerais como "saída em formato JSON" são desnecessárias. Claude já sabe. Por favor, ensine os critérios de julgamento do seu trabalho, como "por que você faz assim" e "em que ordem você faz".
② Divida se exceder 500 linhas
Ele diz 500 linhas, mas na operação real, cerca de 100 linhas para o próprio skill.md é bom. Se o volume aumentar demais, a qualidade do julgamento do Claude Code cairá.
Então, se uma Skill ficar muito grande, armazene os materiais de referência em uma pasta separada. O truque para uso a longo prazo é manter o corpo do SKILL.md focado apenas nas instruções principais.
③ Teste com casos reais, não ideais
Testar com uma solicitação fictícia não tem sentido. Tente com um trabalho que você realmente faz na segunda-feira usando Skills. É no trabalho real que você verá as instruções faltantes.
④ Cultive enquanto usa, em vez de mirar na perfeição
Se você fizer a mesma correção 3 vezes, adicione-a ao SKILL.md. Esta repetição é o caminho mais curto para cultivar uma Skill dedicada a você.
Para Quem Quer Usar de Forma Mais Aprofundada
Esta é a seção avançada.
Nem todo mundo precisa fazer isso imediatamente, mas vou introduzir para quem quer "utilizar ainda mais".
1️⃣ Existem Skills oficiais que você pode usar imediatamente
A Anthropic, desenvolvedora do Claude, lançou oficialmente 5 tipos de Skills.
Processamento de arquivos Word, análise de arquivos Excel, leitura de PDF, geração de PowerPoint e design front-end. Você pode usá-los imediatamente apenas instalando do GitHub.
Existe também um site chamado skills.sh que coleta Skills feitas pela comunidade. No entanto, como são feitas por terceiros, recomendo verificar o conteúdo antes de usar. Há possibilidade de coisas arriscadas estarem incluídas, então preste muita atenção lá.
2️⃣ Existem dois locais de armazenamento: para você e para a equipe
Skills têm dois locais de armazenamento.
Só para você:
Se você colocar em .claude/skills/ na sua pasta home, ela se torna uma Skill dedicada a você que pode ser usada independentemente de qual projeto você abrir.
Para compartilhamento em equipe:
Se você colocar em .claude/skills/ dentro de um projeto, ela é incluída no controle de versão, então todos na equipe podem usar a mesma Skill.
Pessoalmente, acho que esse compartilhamento em equipe é a essência oculta das Skills.
O fato de seus critérios de julgamento se tornarem um arquivo significa que, mesmo que alguém na equipe mude, a qualidade do trabalho é mantida. Os critérios de julgamento não dependem mais de indivíduos. Esta é uma mudança bastante grande para uma organização.
3️⃣ Skills também se conectam com serviços externos
Ao combinar Skills com MCP, um mecanismo para conectar a ferramentas externas, Claude se torna capaz de interagir diretamente com serviços externos.
santtiagom_ descreve isso como "tornar-se capaz de delegar processos em vez de instruções".
No entanto, este é um uso avançado para engenheiros. Recomendo começar com os 6 passos básicos introduzidos na seção anterior.
Resumo
Vou resumir os pontos deste artigo em 6 itens. Por favor, salve para poder consultar depois.
- Skills são "arquivos para configurar fluxos de trabalho na IA". Como uma MT de Pokémon, uma vez configurada, ela ativa toda vez.
- Claude é inteligente, mas não conhece "seu jeito de trabalhar". Sem Skills, você tem que configurar tudo sozinho toda vez.
- Tudo que você precisa é de um arquivo: SKILL.md. O conteúdo é apenas "Nome + Descrição + Instruções".
- Tudo bem colocar 50. Claude seleciona e carrega apenas as Skills necessárias.
- Começar pequeno e cultivar é o caminho certo. Uma Skill funcional de 5 linhas vence uma Skill perfeita com 80 regras.
- A essência das Skills não é automação do trabalho, mas "transformação de julgamento em ativo". O ato de verbalizar seus critérios de julgamento e configurá-los na IA.
Para quem achou este artigo um pouco útil.
O Laboratório Claude Code da Universidade de Tóquio (@ClaudeCode_UT) é uma conta que publica diariamente, centrada em membros que são entusiastas hardcore do Claude Code e estudantes atuais da UTokyo.
Entregamos informações e conhecimentos "genuinamente úteis" especializados para negócios práticos todos os dias.
Seguindo, você pode obter informações como estas 👇
- Guias práticos para "técnicas para fazer a IA aprender trabalho" como Skills e CLAUDE.md
- Explicações dos tópicos mais recentes de utilização de IA do exterior para não-engenheiros
- Este é o único lugar onde você pode receber habilidades de Claude Code "genuinamente úteis" gratuitamente
Se estiver interessado, siga e confira! 👀
Além disso, começamos um LINE oficial, então se você quiser obter informações limitadas rapidamente, junte-se! Vamos acelerar nosso aprendizado e superar a era dos agentes de IA juntos! ❗️
