Quando um novo artigo é publicado no blog do Ahrefs, coloco o URL em Claude e executo /linkedin-pipeline.
Ele extrai o artigo e gera de três a cinco postagens distintas no LinkedIn.
Antes disso, todas as postagens do LinkedIn começavam da mesma maneira. Eu explicaria novamente as regras de voz. A regra da linha de dobra. Os padrões de gancho que eu gosto, os que não gosto. As postagens de exemplo para imitar. O estilo CTA. Redação ligeiramente diferente a cada vez, resultados ligeiramente diferentes a cada vez.
Uma habilidade resolve isso. Você escreve o manual uma vez e Claude o dispara sempre que você pede. Sem nova solicitação. Sem deriva.
Veja o que são Claude Skills, como funcionam e como construir as suas próprias.
Uma habilidade de Claude é um pacote de instruções salvo e reutilizável que Claude dispara automaticamente quando reconhece a tarefa.
Um prompt é uma instrução única. Você digita, Claude responde, a instrução evapora. Da próxima vez, digite-o novamente – ou salve-o como modelo e cole-o novamente. De qualquer forma, é você quem lembra que ele existe, encontra e coloca na frente de Claude.
Uma habilidade é o próximo passo. Você escreve o manual uma vez. Claude lê o que você está perguntando, decide qual habilidade (se houver) se aplica e a segue. Nenhum cardápio. Sem pasta. Você apenas descreve a tarefa com suas palavras normais e o manual salvo é acionado.
O formato é um padrão aberto – a Anthropic o chama de Agent Skills – e o mesmo formato SKILL.md potencializa as habilidades agrupadas no próprio Claude Code. A habilidade que você escreve hoje não está ligada a Claude. Ele é executado em qualquer lugar em que um modelo e um sistema de arquivos possam se comunicar.
Uma habilidade é uma pasta. Dentro, um arquivo chamado SKILL.md: markdown com um pequeno bloco de YAML na parte superior, instruções em linguagem simples abaixo.
—
nome: contorno
descrição: Gere um esboço do artigo na minha estrutura preferida. Use sempre que o usuário solicitar um esboço, estrutura ou títulos de seção para um artigo ou postagem de blog.
—
O frontmatter faz dois trabalhos. Ele nomeia a habilidade e dá uma descrição a Claude.
A descrição é o gatilho: é o que Claude lê para decidir se o seu pedido corresponde a essa habilidade. É também a única parte da habilidade que Claude vê por padrão, então ela precisa funcionar de verdade em uma ou duas frases.
Abaixo do frontmatter, você escreve o manual. Passos, exemplos, regras, o que a tarefa precisar.
A pasta também pode conter arquivos de suporte, como referências de estilo, listas de verificação ou modelos. Claude os puxa apenas quando a habilidade de corrida exige isso. Isto é chamado de divulgação progressiva e é o mecanismo que mantém as competências baratas. Três camadas:
- Frontmatter está sempre em contexto. Descrição e nome. Isto é o que Claude lê ao decidir se deve disparar a habilidade.
- O corpo de SKILL.md é carregado quando a habilidade é disparada. O próprio manual.
- Arquivos vinculados carregue apenas quando o manual disser a Claude para lê-los. Guias de estilo longos, bibliotecas de casos extremos, documentos de API.
Você não está colocando tudo em um prompt gigante. Você está entregando a Claude um kit estruturado, de modo que o custo simbólico de material de referência longo permanece zero até que seja realmente necessário.
A pasta fica em .claude/skills/
Você não precisa ser um desenvolvedor para nada disso. Anthropic publica uma habilidade chamada criador de habilidades em seu repositório de habilidades públicas.
Instale-o uma vez e ele orientará você na criação de novas habilidades, perguntando sobre a tarefa, redigindo o SKILL.md e escrevendo a estrutura de pastas para você. Em Claude.ai, a mesma habilidade é o caminho recomendado em Configurações → Capacidades. Use-o.
Mas saber o que está dentro do arquivo é importante, porque quando a habilidade se comporta mal mais tarde, é você quem a edita.
1. Escolha uma tarefa que você já repete
A maneira mais rápida de perder uma tarde é tentar desenvolver habilidades para tudo de uma vez. Escolha uma tarefa que atenda a dois critérios: você a executa regularmente e se vê reexplicando o mesmo contexto sempre que solicita.
Para mim, foi transformar artigos publicados em postagens no LinkedIn. Para outra pessoa, pode ser transformar uma transcrição em um banco de cotações, ou reescrever um resumo do conteúdo em um tom de voz específico, ou fazer o controle de qualidade de um rascunho de artigo em relação a uma lista de verificação de edição. Todos eles têm a mesma estrutura subjacente: o mesmo tipo de entrada, os mesmos julgamentos, o mesmo tipo de saída, sempre.
Se você não consegue dizer em voz alta, em uma frase, como é um bom resultado, a habilidade não está pronta. Desenvolva os músculos da conversa primeiro.
2. Escreva a descrição como um gatilho real
A descrição é a única coisa que Claude lê ao decidir se deve disparar sua habilidade, então ela tem que fazer três tarefas ao mesmo tempo: dizer o que a habilidade faz, quando Claude deve procurá-la e quais frases-gatilho o usuário pode realmente dizer.
| Trabalho | Exemplo |
|---|---|
| O que isso faz | Gere um esboço do artigo na minha estrutura preferida |
| Quando usar | Sempre que o usuário solicitar um esboço, uma estrutura ou títulos de seção |
| Fases de gatilho | “Esboço”, “estrutura para”, “os ossos de”, “títulos de seção” |
Escreva frases de gatilho da maneira como você realmente solicita a tarefa, não da maneira como uma página de recursos a descreveria. Se você disser “me dê os ossos de um pedaço” e a descrição só souber a palavra “contorno”, a habilidade não será acionada.
Por exemplo, observe a diferença entre uma descrição que é acionada e outra que não:
- Ajuda na escrita. Nunca dispara. Sem gatilho. É apenas uma categoria. Claude não tem nada contra o que se comparar.
- Use quando o usuário solicitar um resumo, recapitulação ou TL;DR de um artigo. Dispara de forma confiável. Tarefa específica, frases-gatilho nomeadas, escopo claro.
3. Mostre, não conte
O corpo da habilidade é onde a maioria das pessoas erra. Eles escrevem “combina com minha voz” e esperam que funcione. Isso não acontece. Instruções vagas produzem resultados vagos.
Quatro coisas que funcionam:
- Exemplos trabalhados. Cole uma entrada real ao lado da saída exata que você deseja. Um bom exemplo supera um parágrafo de instruções.
- Antipadrões explícitos. “Nunca use travessões.” “Nunca abra com uma definição.” “Nunca produza mais de três seções.” Anote as falhas que você já viu, como regras.
- Uma autoverificação no final. Uma pequena lista de verificação que Claude percorre antes de responder detecta desvios que as instruções em prosa não percebem.
- Brevidade. Quanto mais longa e complicada for a habilidade, menor será a probabilidade de Claude segui-la toda. Se uma seção não estiver ganhando seu lugar, corte-a. A orientação de autoria de habilidades da própria Anthropic é manter SKILL.md abaixo de 500 linhas. O modelo não sabe como é a sua boa saída e essa é a única coisa que o corpo deve codificar.
4. Mova conteúdo longo para arquivos separados
Qualquer coisa que sobrecarregue o manual principal, como referências de estilo longas, bibliotecas de exemplo, listas de URLs de concorrentes, documentos de API, fica em um arquivo separado na pasta de habilidades. Eles são referenciados em SKILL.md, mas não colados nele.
A divulgação progressiva faz o resto: o arquivo vinculado só é carregado quando a habilidade de execução o alcança, de modo que o custo do token permanece zero até que seja realmente necessário.
5. Bloqueie habilidades com efeitos colaterais
Se uma habilidade continuar disparando para solicitações que não deveria, ou se executá-la tiver consequências sobre as quais você deseja controle total, defina disable-model-invocation: true no frontmatéria. Claude não dispara automaticamente.
Você o aciona manualmente com /skill-name. Útil para uma habilidade de implantação, uma habilidade de publicação no CMS, uma habilidade que envia uma mensagem do Slack – qualquer coisa que você não queira que um modelo decida executar por conta própria.
Uma habilidade são duas coisas juntas: o conhecimento que você codificou no manual e os dados que o manual pode alcançar. A maioria das pessoas subestima ambos.
A redução leva dez minutos. Articular o que você realmente faz ao construir um resumo de conteúdo – os julgamentos, as regras que você nunca escreveu, as coisas que você rejeita sem pensar – leva o resto da sua carreira. Conectá-lo a dados SERP ativos, seu CMS e seu guia de estilo é um projeto separado além disso.
Veja o caso de Ryan Law, nosso Diretor de Marketing de Conteúdo. Recentemente, ele publicou uma postagem sobre como construiu um pipeline de engenharia de conteúdo de 23 habilidades em Claude Code, acorrentado a uma habilidade principal de pipeline de blog que gera artigos prontos para publicação em seis a doze minutos.
O que vale a pena notar é para onde o trabalho realmente foi. Um comentarista do LinkedIn colocou melhor:
Os arquivos SKILL de Ryan são bons porque Ryan já sabia o que colocar neles. A maioria das pessoas que usam ferramentas em branco não tem 13 anos de experiência editorial para construir. A lacuna não está apenas na ferramenta. Está na pessoa por trás disso também.
Treze anos de experiência editorial de um lado. O MCP do Ahrefs foi conectado do outro lado para que as habilidades pudessem extrair dados reais em vez de aluciná-los. A redução no meio foi a parte fácil.
Você pode construir tudo isso sozinho se tiver as habilidades (heh) e a experiência. Caso contrário, você pode confiar nos outros.
Claude Code vem com habilidades agrupadas disponíveis em cada sessão: /batch, /claude-api, /debug, /loop e /simplify. Eles funcionam no momento em que você instala o Claude Code. A Anthropic também publica um repositório de habilidades públicas você pode bifurcar, copiar e modificar, e os diretórios da comunidade estão começando a aparecer.
Especificamente para SEO e marketing, você tem o Agente A. É um agente de IA com acesso irrestrito aos dados do Ahrefs, além de integrações com ferramentas importantes como Notion, HubSpot, WordPress, Slack e Google Search Console.
Descreva o que você deseja – ferramentas, relatórios, aplicativos, painéis e, sim, habilidades – e o Agente A irá projetar, escrever e implantá-los. Ele fica no seu espaço de trabalho, lembra as decisões que vocês tomaram juntos e tem como escopo seus dados e ferramentas.
Também pré-construímos uma biblioteca de habilidades de marketing, com curadoria de nossa equipe interna de especialistas e sintonizada com o trabalho real de marketing. Por exemplo, você pode iniciar automaticamente habilidades para executar uma análise de sentimento de marca de IA, executar uma análise de lacunas de conteúdo, detectar conteúdo com tráfego decrescente, encontrar oportunidades de linkbait e muito mais.
O Agente A é executado no mesmo formato SKILL.md do Claude Code. Portanto, mesmo que você tenha uma biblioteca de habilidades construída no Claude Code, você pode facilmente movê-las para o Agente A.
Considerações finais
O formato da habilidade é mais importante do que parece. É o mecanismo que transforma Claude de uma janela de bate-papo sobre a qual você fica se reexplicando, em algo que você treina. Depois de desenvolver três ou quatro habilidades que você realmente usa, você para de digitar instruções e começa a acionar sistemas.
Escreva um pequeno esta semana. Escolha uma tarefa que você faz todas as terças-feiras e esqueça exatamente como você a faz. Execute o criador de habilidades ou descreva-o para Agente A e deixe-o elaborar, instalar e testar a habilidade para você. Quinze minutos de qualquer maneira.
Na próxima vez que a tarefa for realizada, você saberá se realmente construiu algo – ou apenas fez uma solicitação mais sofisticada. Passe nesse teste uma vez e você continuará desenvolvendo habilidades para sempre.
