Como automatizar processos repetitivos com habilidades customizadas no Claude Code
⚡O que são Skills?
Uma Skill é um processo codificado. Uma sequência de passos obrigatórios que o Claude executa toda vez que você aciona o comando. É diferente de um Project: o Project dá contexto, a Skill define um fluxo de trabalho.
Pense assim: se você faz a mesma tarefa mais de uma vez por semana e segue sempre os mesmos passos, ela é candidata a virar uma Skill.
🌟O que você vai aprender
A diferença real entre um Project e uma Skill
Como identificar processos que merecem virar Skill
Como usar o próprio Claude para criar o código da sua Skill
Como instalar, testar e evoluir suas Skills
A Skill do Roteiro de Reels como exemplo completo
O que você terá ao final
Ao final desta aula
Você terá
Conceito claro
Entender quando usar Skill vs Project
Primeiro processo mapeado
Um processo repetitivo identificado para virar Skill
Skill criada
Código gerado pelo Claude e pronto para instalar
Skill instalada
Disponível no seu Claude Code com um comando /
Template de referência
A Skill do Roteiro de Reels para usar e adaptar
Início
Projeto vs Skill
Entenda a diferença e quando usar cada um, eles se complementam
📄 Project
⚡ Skill
O que éUm espaço com contexto fixo: documentos, system prompt e histórico
O que éUm processo codificado com etapas obrigatórias que o Claude executa
Como funcionaO Claude lê os documentos que você subiu e usa esse contexto em todas as conversas
Como funcionaVocê chama com um comando /skill e o Claude segue o fluxo definido no arquivo SKILL.md
Melhor paraConversas estratégicas, perguntas abertas, decisões que precisam do contexto da empresa
Melhor paraTarefas repetitivas com resultado padronizado: roteiros, carrosséis, briefings, análises
AnalogiaUm consultor que conhece a sua empresa de cor
AnalogiaUm colaborador que sabe exatamente como executar um processo específico
Use os dois juntos
O Project dá profundidade. O Claude conhece seu negócio. A Skill dá velocidade. O Claude executa seu processo. Usar um Project como contexto e Skills para tarefas operacionais é a combinação ideal.
💡A sacada da aula
Skills existem para replicar o processo que você executa na sua cabeça. Em vez de explicar para o Claude o que fazer toda vez, você descreve o processo uma vez, ele vira código, e aí é só acionar.
Pensa na Skill do Roteiro: você pode ter uma skill para roteiro do canal A, outra para o canal B, cada uma com o tom e estrutura específicos. São processos diferentes, cada um com seu arquivo.
Como criar
Passo 1. Identifique o Processo
Antes de criar qualquer Skill, mapeie o que você faz repetidamente
PASSO 01Mapeie tarefas repetitivas e desenhe o processo
1
Pense em tarefas que você faz toda semana e que sempre seguem os mesmos passos. Exemplos: escrever roteiros, montar briefings, criar pautas, analisar textos.
2
Para cada tarefa candidata, responda: existe uma sequência de etapas que eu sempre sigo? Se sim, ela pode virar uma Skill.
3
Escreva as etapas do processo em ordem. Exemplo para roteiro de Reels: 1. recebo um tema ou notícia, 2. pesquiso dados atuais, 3. crio um resumo dos pontos-chave, 4. escrevo o roteiro em formato teleprompter.
4
Identifique o input (o que entra) e o output (o que sai). A Skill recebe um input e produz um output padronizado.
Candidatos ideais para Skills
Processo
Input
Output
Roteiro de Reels
Tema ou notícia
Roteiro em teleprompter
Post de Carrossel
Tema + quantidade de slides
Textos de cada slide formatados
Briefing de Reunião
Objetivo da reunião + participantes
Pauta estruturada + perguntas-chave
Análise de Proposta
Texto da proposta
Pontos fortes, riscos e recomendação
Roteiro de Vídeo Longo
Tema + duração desejada
Roteiro completo com marcações
Comece simples
Sua primeira Skill não precisa ser perfeita. Comece com o processo mais simples que você faz repetidamente. A iteração é parte do método: você vai evoluir de v1 para v2 para v3 conforme usa.
Como criar
Passo 2. Criar a Skill com Claude
Use o próprio Claude para escrever o código da sua Skill
PASSO 02Cole o prompt de criação e deixe o Claude gerar o SKILL.md
1
Abra uma nova conversa no Claude (fora de qualquer Project, para não misturar contexto).
2
Copie o prompt de criação de Skill abaixo e cole no chat. Preencha as lacunas com o processo que você mapeou no Passo 1.
3
O Claude vai gerar o arquivo SKILL.md completo e te orientar sobre como instalar. Ele mostra o passo a passo de instalação automaticamente.
4
Se quiser usar uma Skill existente como referência, copie o código dela e inclua no prompt. Isso ajuda o Claude a entender a estrutura esperada.
Prompt para criar uma Skill, cole no Claude
Quero criar uma nova Skill para o Claude Code. Segue abaixo o processo que quero automatizar:
**Nome da Skill:** [ex: roteiro-reels]
**Comando de ativação:** /[ex: roteiro-reels]
**Descrição:** [ex: Cria roteiro para Reels a partir de um tema ou notícia]
**O que recebe como entrada:**
[ex: Um tema, ou uma notícia/artigo colado pelo usuário]
**Etapas obrigatórias do processo:**
1. [ex: Fazer 2 buscas — uma sobre o tema e outra sobre tendências recentes]
2. [ex: Criar um resumo interno com os 3-5 pontos principais]
3. [ex: Escrever o roteiro em formato teleprompter com gancho, desenvolvimento e CTA]
**Tom e estilo do output:**
[ex: Direto, sem jargão, frases curtas, formatado em blocos com títulos em maiúsculas]
**Informações adicionais (opcional):**
[ex: O roteiro é para um canal de educação financeira. Tom: acessível, sem termos técnicos]
Por favor:
1. Escreva o arquivo SKILL.md completo e pronto para instalar
2. Me oriente como criar o diretório e onde salvar o arquivo
3. Me explique como ativar a skill após instalar
Referência de estrutura
Se você já tem uma Skill instalada e quer criar outra no mesmo formato, copie o conteúdo do arquivo SKILL.md existente e cole no início do prompt como "Aqui está uma Skill existente para referência de estrutura:". Isso acelera muito a criação.
Como criar
Passo 3. Instalar a Skill
Copie o arquivo gerado para o diretório correto e ative no Claude
PASSO 03Crie o diretório, cole o SKILL.md e salve
1
O Claude gerou o arquivo SKILL.md. Copie o conteúdo completo do arquivo que ele criou.
2
Abra o Terminal (Mac) ou Prompt de Comando (Windows). Crie o diretório da sua Skill com o comando abaixo. Substitua nome-da-skill pelo nome que você escolheu.
Terminal, criar diretório da Skill
mkdir -p ~/.claude/skills/nome-da-skill
3
Crie o arquivo SKILL.md dentro do diretório e cole o conteúdo gerado pelo Claude. Você pode usar qualquer editor de texto: VS Code, TextEdit, Notepad.
Terminal, abrir arquivo para edição (VS Code)
code ~/.claude/skills/nome-da-skill/SKILL.md
4
Salve o arquivo. A Skill estará disponível automaticamente na próxima vez que você abrir o Claude Code. Não é necessário reiniciar o computador.
5
No Claude Code, você também pode editar a Skill diretamente clicando em "Edit" no painel de Skills, sem precisar abrir o terminal.
Onde ficam as Skills
As Skills pessoais ficam em ~/.claude/skills/. Esse diretório funciona para todas as suas conversas no Claude Code. Skills dentro de um projeto específico ficam em .claude/skills/ na raiz do projeto.
Atenção ao nome do diretório
O nome do diretório vira o comando de ativação. Se você criar ~/.claude/skills/roteiro-reels/, o comando será /roteiro-reels. Use kebab-case (letras minúsculas com hífens, sem espaços ou caracteres especiais).
Como criar
Passo 4. Testar e Otimizar
Rode a Skill com um caso real, identifique vícios e itere
PASSO 04Use um caso real, anote padrões problemáticos e edite o SKILL.md
1
Abra o Claude Code e ative sua Skill digitando /nome-da-skill no chat seguido do seu input de teste.
2
Use um caso real, não um exemplo genérico. Quanto mais próximo da realidade, mais fácil identificar onde a Skill precisa melhorar.
3
Analise o resultado e anote padrões problemáticos: linguagem genérica de consultoria, números desnecessários, estrutura que não encaixa no seu fluxo, jargões que você nunca usaria.
4
Edite o arquivo SKILL.md diretamente (ou com o Claude) para corrigir os problemas identificados. Cada iteração melhora o resultado.
5
Quando o resultado estiver consistente e bom, a Skill está institucionalizada. Pode ser compartilhada com o time ou publicada no repositório de Skills do time.
🔄O ciclo de evolução
Nenhuma Skill nasce pronta. O processo natural é:
v1.0, Skill gerada, resultado funciona mas tem padrões ruins
v2.0, você testou e ajustou os vícios principais
v3.0, incorporou adaptações reais do seu uso em produção
A Skill do Roteiro mostrada na aula já estava na versão 2.0. O primeiro resultado já tinha sido otimizado com feedback real de quem usou.
Dica de otimização
Quando encontrar um output que ficou muito bom, copie os trechos que funcionaram bem e adicione como exemplos no SKILL.md. Dizer "escreva assim como no exemplo abaixo" funciona melhor do que descrever o formato abstratamente.
Exemplos
Exemplos de Skills
Inspire-se com Skills para criar conteúdo e automatizar processos do dia a dia
🎬
Roteiro de Reels
/roteiro-reels
Recebe um tema ou notícia, faz 2 buscas, cria resumo e gera roteiro em teleprompter com gancho, desenvolvimento e CTA. Exemplo completo disponível na seção "Skill do Roteiro".
📃
Post de Carrossel
/carrossel
Recebe tema e número de slides. Pesquisa dados atuais, define ângulo de entrada impactante, escreve cada slide com título e corpo, formata com CTA final.
🌟
Roteiro Personalizado (por criador)
/roteiro-criador
Versão da skill de roteiro adaptada para o tom, linguagem e estrutura específica de um criador de conteúdo. Cada pessoa pode ter a própria versão da skill.
📋
Briefing de Reunião
/briefing
Recebe objetivo e participantes da reunião. Gera pauta com tempo estimado por tópico, perguntas-chave para cada ponto e materiais que devem ser preparados.
🔍
Análise de Proposta Comercial
/analisa-proposta
Recebe o texto de uma proposta. Extrai pontos fortes, identifica riscos, faz perguntas que deveriam ser respondidas antes de assinar e dá recomendação clara.
📰
Resumo de Artigo ou Notícia
/resumo
Recebe URL ou texto de um artigo. Extrai o argumento central, 3 a 5 pontos principais, implicações para o seu setor e uma pergunta estratégica para reflexão.
Crie a sua biblioteca
Cada processo que você executa bem pode virar uma Skill. Com o tempo, você terá uma biblioteca pessoal. Uma coleção de processos operacionais que qualquer pessoa do time pode usar com um único comando.
Exemplos
A Skill do Roteiro
Referência completa. Transforma tema ou notícia em roteiro para Reels
💡Como funciona
Você cola um tema ou notícia e digita /roteiro-reels. A Skill executa automaticamente:
2 buscas obrigatórias, uma sobre o tema principal, outra sobre tendências recentes
Resumo interno, os 3 a 5 pontos mais relevantes encontrados
Roteiro em teleprompter, gancho (0-3s), contexto, desenvolvimento com 3 pontos e CTA
O resultado é um roteiro pronto para gravar. Sem números desnecessários, sem jargão de consultoria, no tom que você usa.
SKILL.md, Skill do Roteiro de Reels (v2.0)
---
description: Criar roteiro para Reels a partir de um tema ou notícia. Use para: roteiro reels, script video, conteúdo instagram, roteiro social media.
---
# Skill: Roteiro para Reels
Você vai criar um roteiro profissional e direto para um Reel de 60–90 segundos.
## Entradas
O usuário vai fornecer:
- Um tema (ex: "inteligência artificial no varejo"), ou
- Uma notícia ou artigo colado no chat
## Processo Obrigatório
### Etapa 1: Pesquisa (execute SEMPRE, nunca pule)
Faça exatamente 2 buscas na web:
1. Busca pelo tema/notícia principal — procure dados concretos e atualizados
2. Busca por "[tema] tendências 2025" ou um ângulo de novidade sobre o tema
### Etapa 2: Resumo Interno
Crie um bloco interno de análise com:
- 3 a 5 dados ou fatos concretos encontrados nas buscas
- O ângulo de entrada mais impactante para o Reel
- O que o público ainda não sabe sobre esse tema
### Etapa 3: Roteiro Final
Estrutura obrigatória (respeite a ordem):
GANCHO (0-3s)
Frase única que para o scroll. Regras:
- Nunca comece com "Hoje vou falar sobre..."
- Nunca comece com uma pergunta genérica
- Use um dado surpreendente ou uma afirmação forte
CONTEXTO (4-10s)
Um fato ou dado concreto que amplia o gancho.
Mostre que o assunto é relevante AGORA.
DESENVOLVIMENTO (11-50s)
Exatamente 3 pontos. Cada um com:
- Número + título curto
- Explicação em 1-2 frases diretas
- Dado ou exemplo concreto quando possível
CTA (51-60s)
Uma chamada para ação específica. Não use CTAs genéricos.
Exemplos bons: "Salva esse vídeo antes de tomar essa decisão"
Exemplos ruins: "Me segue para mais conteúdo"
## Regras de Tom e Formato
- Linguagem: direta, sem jargão, como você falaria com um amigo inteligente
- Frases curtas — uma ideia por linha para facilitar o teleprompter
- Sem introduções longas, sem "como vocês sabem..."
- Separe cada bloco com o título em maiúsculas
- Adicione [PAUSA] e [ÊNFASE] nos momentos estratégicos
- Nunca use linguagem genérica de consultoria
## Formato de Saída
Apresente o roteiro formatado para teleprompter:
- Cada linha = uma fala
- Blocos separados por título em MAIÚSCULAS
- Notas de direção entre [colchetes]
- Duração estimada ao final de cada bloco
Como adaptar para o seu canal
Copie esse SKILL.md, salve como base e edite:
O campo description, adicione palavras-chave que vão acionar a Skill
O tom e exemplos de linguagem, substitua pelos seus exemplos reais
A estrutura do roteiro, adapte para o formato que você usa no seu canal
O CTA, coloque o CTA padrão que você usa em vez dos exemplos genéricos
Prompt para criar sua versão personalizada
Prompt, adaptar a Skill para o seu canal
Aqui está o SKILL.md da Skill do Roteiro de Reels que tenho instalada:
[cole o SKILL.md acima]
Quero adaptar essa Skill para o meu canal. As diferenças são:
**Meu canal:** [ex: canal sobre empreendedorismo para donos de pequenos negócios]
**Meu tom:** [ex: descontraído, com exemplos práticos, sem termos técnicos]
**Estrutura que prefiro:** [ex: gancho com pergunta provocadora, depois história de 10s, depois 3 passos]
**CTA padrão que uso:** [ex: "Comenta aqui o maior desafio do seu negócio"]
**Duração alvo:** [ex: 45 segundos]
Por favor, reescreva o SKILL.md completo adaptado para o meu canal.
Ação
Seus Próximos Passos
O checklist para sair com sua primeira Skill funcionando hoje
☐
Prazo
Ação
Hoje
Identificar um processo repetitivo para virar Skill
Hoje
Usar o prompt de criação para gerar o SKILL.md com o Claude
Hoje
Criar o diretório e instalar o arquivo SKILL.md
Esta semana
Testar a Skill com 3 casos reais e anotar o que precisa melhorar
Esta semana
Fazer pelo menos uma iteração (v2.0) com base no feedback real
Próximo mês
Criar uma segunda Skill para outro processo do time
Próximo mês
Compartilhar uma Skill funcional com o time na próxima reunião
Traga para o time
Se você criar uma Skill que funciona bem, traga para o grupo. O objetivo é construir uma biblioteca coletiva de Skills operacionais que qualquer pessoa do time possa usar e adaptar.
👥Compartilhe com seu time
Skills podem ser instaladas em projetos. Basta colocar o arquivo .claude/skills/nome-da-skill/SKILL.md na raiz do repositório do projeto. Qualquer pessoa que clonar o projeto terá acesso à Skill automaticamente.