Como transformar uma rotina de marketing repetida em uma skill do Claude

Fala aí, beleza? Toda segunda alguém do time abre o mesmo documento, copia aquele prompt gigante, cola no Claude e pede o relatório da semana

Aí muda uma palavra aqui, esquece um critério ali, e a entrega sai diferente da que saiu na semana passada…

A proposta deste post é outra: descrever o processo UMA vez, em texto claro, e guardar isso como uma skill do Claude

Skills são pastas com instruções, scripts e recursos que o Claude carrega dinamicamente para tarefas especializadas, seguindo o padrão aberto Agent Skills. O Claude Code segue esse padrão e adiciona recursos próprios, como controle de invocação, execução em subagente e injeção dinâmica de contexto

Já aviso o recorte: aqui o foco é o MÉTODO de descrever a tarefa, beleza? Sem promessa de resultado, sem fórmula mágica, sem prompt secreto

O que você precisa antes de começar

Antes de sair criando pasta, três coisas precisam existir

1. Uma rotina que a equipe já entrega de forma repetida

Relatório semanal, briefing de campanha, calendário de conteúdo, checklist de revisão. Se a entrega acontece toda semana com a mesma cara, ela é candidata

Pré-inscrição Formação Claude Code

Domine o Claude Code do básico ao avançado

Você vai aprender a criar sistemas completos com Claude Code, sem precisar ser programador. Inscreva-se para ter acesso a um desconto de lançamento e bônus especiais!

Quero minha vaga

2. O processo dessa rotina escrito em texto

E aqui não é o resultado, é o procedimento: qual a entrada, quais as etapas na ordem, qual o formato de saída e quais os critérios de aceite

Se você não consegue escrever isso pra um humano novo no time, também não vai conseguir escrever pra IA

3. A decisão de escopo

No Claude Code as skills personalizadas são baseadas em sistema de arquivos e não exigem upload por API

Que escopo? São dois caminhos: ~/.claude/skills/ para skills pessoais, que te seguem em qualquer projeto, e .claude/skills/ para skills do projeto

O escopo de projeto instala em .claude/skills/ no repositório atual, indicado justamente para skills específicas daquele contexto e que devem ser compartilhadas com o time via controle de versão

Regra prática: começa pessoal enquanto a coisa está tosca, versiona no projeto quando já estiver estável 🙂

Passo a passo: da rotina repetida à skill funcionando

1. Escolha UMA entrega recorrente e escreva o processo:

Uma só. Não é pra mapear o setor inteiro no primeiro dia

Pega a entrega mais repetida da semana e escreve, em português mesmo, o passo a passo de como ela é feita hoje

O erro comum deste passo: descrever o RESULTADO desejado em vez do procedimento. "Quero um relatório bonito e completo" não é processo, é desejo

2. Crie a pasta da skill:

Cada skill é uma pasta autocontida que tem, no mínimo, um arquivo SKILL.md com as instruções e os metadados

# skill pessoal
mkdir -p ~/.claude/skills/relatorio-semanal-marketing

# skill do projeto (vai versionada no repo)
mkdir -p .claude/skills/relatorio-semanal-marketing

O erro comum deste passo: espalhar instrução meia boca em três lugares diferentes. A graça da pasta autocontida é que tudo daquela rotina mora ali dentro

3. Escreva o frontmatter do SKILL.md:

O SKILL.md começa com frontmatter YAML entre marcadores ---, contendo os campos de metadados name e description

---
name: relatorio-semanal-marketing
description: Monta o relatório semanal de marketing a partir do export de métricas da semana, com resumo por canal, comparativo com a semana anterior e lista de recomendações
---

O erro comum deste passo: description vaga tipo "ajuda com marketing"

E por que isso é grave? Porque o Claude descobre e usa as skills automaticamente: ele casa o pedido do usuário com a description da skill pra decidir quando carregá-la

Description ruim é skill que existe no disco e nunca é chamada

4. Escreva o corpo em markdown:

Abaixo do frontmatter vão as instruções, em markdown normal. É aqui que entra o processo que você escreveu no passo 1

## Entrada
Export de métricas da semana (csv) e o relatório da semana anterior

## Etapas
1. Conferir se o período do export bate com a semana pedida
2. Consolidar por canal
3. Comparar com a semana anterior e apontar variações
4. Listar recomendações ligadas às variações encontradas

## Formato de saída
Resumo executivo, tabela por canal, variações e recomendações

## Critérios de aceite
Toda recomendação precisa citar o número que a motivou
Sem número no export, escrever "sem dado" em vez de estimar

O erro comum deste passo: tentar enfiar o processo inteiro dentro do frontmatter. Frontmatter é metadado, corpo é instrução

5. Distribua o material de apoio em subpastas:

Uma skill pode levar arquivos de apoio além do SKILL.md, organizados em subpastas /scripts, /references e /assets, com scripts Python ou shell, templates e outros recursos

.claude/skills/relatorio-semanal-marketing/
├── SKILL.md
├── scripts/
├── references/
└── assets/

E por que separar em vez de colar tudo no SKILL.md? Por causa da divulgação progressiva, que funciona em três níveis de carregamento de contexto

• nível 1: nome e descrição de cada skill instalada entram no contexto inicial
• nível 2: o corpo do SKILL.md é lido quando a skill é considerada relevante
• nível 3: arquivos de apoio e scripts são lidos ou executados só durante a execução

Ou seja: o template gigante de briefing não fica pesando na sessão inteira, ele só aparece na hora que a skill roda. MUITO massa isso

6. Use os campos opcionais quando fizer sentido:

No frontmatter do Claude Code existem campos opcionais além de name e description, entre eles disable-model-invocation e allowed-tools

O primeiro tem a ver com controle de invocação, e o segundo restringe quais ferramentas ficam disponíveis com a skill ativa

O erro comum deste passo: sair configurando campo opcional antes da skill funcionar no básico. Primeiro faz rodar, depois aperta o cinto

7. Teste com as palavras que a equipe usa:

Não chame a skill pelo nome no teste. Peça a rotina exatamente como o time pede no dia a dia ("monta o relatório da semana pra mim") e veja se ela é acionada

Como o acionamento é automático por relevância, se não pegou, o ajuste não é no corpo: é na description

O erro comum deste passo: reescrever as etapas quando o problema era o gatilho

8. Compartilhe com o time:

Caminho mais simples: versionar .claude/skills/ no repositório, e pronto, quem clona o projeto já tem a skill

Caminho empacotado: no Claude Code, plugins empacotam uma ou mais skills (além de hooks, comandos, agentes e configurações de MCP) em uma unidade instalável, gerenciada pelo comando /plugin, que abre a interface com as abas Discover, Installed, Marketplaces e Errors

Pra distribuir, publica-se um marketplace: um repositório git com um arquivo marketplace.json listando os plugins

/plugin marketplace add <repo>

Aí os colegas adicionam o marketplace e instalam os plugins

E se você quiser apoio pra escrever, melhorar e avaliar as suas skills, a Anthropic mantém um repositório público de Agent Skills no GitHub, com a skill-creator em skills/skill-creator, com SKILL.md, scripts, references e assets

Ela serve pra criar novas skills, modificar e melhorar as existentes e medir o desempenho delas, cobrindo captura de intenção, rascunho, criação de casos de teste, avaliação e iteração

O que aprendi usando skills nos meus projetos

Eu uso um conjunto fixo de skills em praticamente todo projeto que começo com Claude Code

Só que a etapa que mais rende não é skill pronta de repositório: é criar a MINHA, porque cada projeto varia de tecnologia e de regra de negócio

Eu prefiro escrever a skill sob medida em vez de instalar uma genérica de terceiros, mesmo pedindo pro próprio Claude redigir o arquivo, porque quero ela alinhada ao que estou construindo

E eu defendo que skill customizada fica melhor dentro do projeto, não no escopo global. A do exemplo eu criei como skill de projeto, dava pra ter feito global, mas não faria sentido

O que mais mudou o resultado foi o jeito de descrever a tarefa

No prompt de criação eu exijo verificação MECÂNICA: rodar comandos reais e contar os problemas encontrados, em vez de deixar a IA opinar solta

Depois eu descrevo item por item o que a skill deve checar (segredos, entradas, autenticação, dependências, cabeçalhos), puxando da minha própria vivência sobre o que costuma dar problema, e amarro tudo nas tecnologias e regras daquele projeto

E defino o formato exato da saída: nota total, quebra por categoria e lista dos problemas encontrados, pra ela devolver sempre o mesmo relatório

Se a instrução fica genérica demais, você recebe opinião. Se fica presa demais num detalhe que não é regra do projeto, ela atrapalha mais do que ajuda

Outra coisa: depois que o Claude gera o arquivo, eu ABRO e leio o conteúdo antes de confiar na execução. Não é porque ele escreveu que está certo

Quando rodei a skill no projeto, a saída veio com a pontuação, onde foram perdidos pontos e até uma seção explicando como usar a própria skill

E tem o dado de primeira mão que mostra o tamanho da coisa: o plano de implementação do projeto de exemplo gerou 14 tarefas

O mesmo caminho serve pra skill de criar página, de performance web ou de SEO, dependendo do que aquele projeto exige

Nada disso é bala de prata, tá? Estou mostrando o que funciona na minha rotina

E, sinceramente, boa parte das reclamações de que a IA não entrega o que se espera vem de prompt ruim, não da ferramenta

No vídeo abaixo eu mostro essa sequência rodando, incluindo a parte de escrever a skill própria e ler o arquivo gerado antes de usar:

Que rotinas de marketing valem virar skill

O critério é seco: rotina com processo estável e formato de saída definido vira skill, pedido pontual não vira

Se a entrega termina em arquivo, se liga: existem skills prontas voltadas a formatos de documento, para PowerPoint (pptx), Excel (xlsx), Word (docx) e PDF

Dá pra encurtar caminho olhando o que já existe também: vale garimpar skills de marketing prontas no GitHub antes de escrever a sua do zero

E quem não usa Claude Code?

Aqui um aviso importante, porque muita gente mistura os produtos

No Claude.ai e no Claude Desktop, as skills são habilitadas em Settings > Capabilities > Skills, onde se faz upload e se liga ou desliga cada skill

Esse caminho é do Claude.ai, NÃO é instrução de Claude Code. No Claude Code o jogo é o sistema de arquivos, aquelas pastas que a gente viu lá em cima

E em organizações nos planos Team e Enterprise do Claude.ai, os owners provisionam skills para todo o workspace em Organization settings > Skills, com as skills da organização aparecendo para todos os usuários e podendo ser ligadas ou desligadas individualmente

Por onde começar hoje

Recapitulando o caminho: escolhe a entrega mais repetida da semana, escreve o processo dela em texto (entrada, etapas, formato de saída, critérios de aceite) e transforma isso no seu primeiro SKILL.md

Começa pessoal, em ~/.claude/skills/, onde você pode errar à vontade e reescrever a description umas cinco vezes até o acionamento automático pegar

Quando a rotina estiver rodando redonda, aí sim move pra .claude/skills/ e versiona no repositório pro time inteiro usar a mesma

É isso, o segredo não está em prompt mágico, está em descrever direito o que você já sabe fazer 😀

até o próximo post!