TL;DR
Criei 5 skills customizadas no Claude Code
Economizei 12 horas de trabalho repetitivo essa semana
Você vai aprender: como criar suas próprias skills do zero
Inclui: Prompts copiáveis e Tutorial passo-a-passo
Bônus: Como integrar MCP para conectar ferramentas externas
O Problema Que Eu Tinha
Durante 2 meses usando o Claude Code, eu só usava as skills que vinham prontas.
Funciona. Mas é genérico.
Eu fazia:
❌ Code review manual (30 min por PR)
❌ Criava testes copiando estrutura de outros (20 min por feature)
❌ Otimizava performance "no feeling" (1h+ por problema)
Total: 3-4 horas/dia em trabalho repetitivo.
Pior: Cada vez eu refazia o prompt do zero. Inconsistente.
A Descoberta
Descobri que posso criar minhas próprias skills.
Skills customizadas = Prompts profissionais automatizados.
Passei um fim de semana criando 5 skills para minhas tarefas mais comuns.
Resultado essa semana:
✅ Code review: 30 min → 5 min (6x mais rápido)
✅ Testes: 20 min → 3 min (7x mais rápido)
✅ Otimização: 1h+ → 15 min (4x mais rápido)
Total economizado: ~12 horas em uma semana.
Como Funcionam Skills Customizadas
Estrutura Básica
Skills ficam em .claude/skills/:
.claude/skills/
review-pr.md
generate-tests.md
optimize-code.md
Cada skill = arquivo markdown com:
Nome da skill
Descrição
Prompt estruturado
Parâmetros de entrada
Output esperado
Exemplo: Skill de Code Review
Criei review-pr.md:
# Code Review Sistemático
## Descrição
Realiza code review seguindo metodologia 3 Passes profissional.
## Input
- Branch ou arquivos modificados
## Processo
### Pass 1: Estrutura (2 min)
- Arquitetura faz sentido?
- Responsabilidades bem definidas?
- Nomenclatura clara?
### Pass 2: Lógica (3 min)
- Lógica está correta?
- Edge cases cobertos?
- Testes adequados?
### Pass 3: Segurança (2 min)
- Vulnerabilidades (XSS, SQL injection, etc)?
- Dados sensíveis expostos?
- Validação de inputs?
## Output
Relatório estruturado com:
- 🟢 Aprovado
- 🟡 Aprovado com ressalvas
- 🔴 Requer mudanças
Lista de issues priorizadas por severidade.
Uso:
claude code
> /skill review-pr
Claude executa o review completo em 5 minutos.
Antes: 30 minutos manuais.
As 5 Skills Que Criei
1. Review-PR (Economiza 25 min/review)
O que faz: Code review metodologia 3 passes
Quando usar: Antes de mergear PR
Resultado: Encontrei 11 bugs que ia subir pra produção
2. Generate-Tests (Economiza 17 min/feature)
O que faz: Gera suite de testes completa (happy path + edge cases + failures)
Quando usar: Após implementar feature nova
Resultado: Coverage subiu de 60% pra 95%
3. Optimize-Code (Economiza 45 min/otimização)
O que faz: Analisa performance e sugere otimizações específicas
Quando usar: Quando código está lento
Resultado: Reduzi tempo de resposta de API de 800ms pra 120ms
4. Debug-Systematic (Economiza 20 min/bug)
O que faz: Debugging estruturado em 4 etapas (Isolar → Diagnosticar → Solução → Prevenir)
Quando usar: Bug intermitente ou complexo
Resultado: Resolvi bug que estava aberto há 2 semanas em 15 minutos
5. Refactor-Safe (Economiza 30 min/refactor)
O que faz: Refactoring mantendo comportamento idêntico + testes automáticos
Quando usar: Código legacy ou difícil de manter
Resultado: Refatorei função de 200 linhas em 8 funções pequenas, zero bugs
Tutorial: Criando Sua Primeira Skill
Passo 1: Identifique a Tarefa Repetitiva
Pergunte-se:
Que tarefa eu faço 3+ vezes por semana?
Qual sempre segue o mesmo padrão?
Onde eu perco mais tempo?
Exemplo: "Code review"
Passo 2: Crie o Arquivo da Skill
mkdir -p .claude/skills
touch .claude/skills/minha-skill.md
Passo 3: Estruture o Prompt
Template básico:
# [Nome da Skill]
## Descrição
[O que faz em 1-2 linhas]
## Input
[O que precisa receber]
## Processo
[Passo-a-passo que Claude deve seguir]
## Output
[Formato da resposta]
## Exemplo
[Caso de uso real]
Passo 4: Teste e Ajuste
claude code
> /skill minha-skill
Rode 3-5 vezes. Ajuste prompt baseado nos resultados.
Passo 5: Documente o Uso
Adicione em .claude/README.md:
## Skills Customizadas
### minha-skill
**Uso**: `/skill minha-skill`
**Quando**: [cenário]
**Economiza**: [tempo]
BÔNUS: Integrando MCP (Model Context Protocol)
MCP permite conectar o Claude com ferramentas externas.
Exemplo: Criar PR Automaticamente no GitHub
1. Instale MCP Server:
npm install -g @anthropic/mcp-server-github
2. Configure .claude/mcp.json:
{
"servers": {
"github": {
"command": "mcp-server-github",
"args": ["--token", "${GITHUB_TOKEN}"]
}
}
}
3. Crie Skill .claude/skills/create-pr.md:
# Criar PR Automaticamente
## Processo
1. Verifica branch atual
2. Lista commits desde main
3. Gera descrição do PR baseada nos commits
4. Cria PR via GitHub API (MCP)
5. Adiciona labels automaticamente
4. Use:
> /skill create-pr
Claude cria o PR completo no GitHub. Zero cliques.
Resultados Dessa Semana
Depois de criar as 5 skills:
Antes:
Code review: 30 min
Testes: 20 min
Debug: 45 min
Otimização: 1h
Refactor: 30 min
Total: 3h 5min/dia em tarefas repetitivas
Depois (com skills):
Code review: 5 min
Testes: 3 min
Debug: 10 min
Otimização: 15 min
Refactor: 10 min
Total: 43 min/dia
Economia: 2h 22min/dia = ~12h/semana
Quando Criar Uma Skill Customizada
✅ Crie quando:
Tarefa repetitiva (3+ vezes/semana)
Processo bem definido
Você quer resultado consistente
Economiza 10+ minutos por execução
❌ Não crie quando:
Tarefa única ou rara
Processo ainda indefinido
Prompt simples (1-2 linhas)
Regra prática: Se você faz 3+ vezes, automatize.
Próximos Passos
Hoje: Identifique sua tarefa mais repetitiva
Amanhã: Crie sua primeira skill (use o template acima)
Esta semana: Teste e ajuste baseado nos resultados
Próxima semana: Crie mais 2-3 skills
Meta: 5 skills customizadas em 2 semanas.
🎥 Tutorial em Vídeo
Gravei tutorial completo (15 min) mostrando:
Como criar skill do zero
Testar e ajustar
Configurar MCP
Usar as 5 skills que criei
📚 Documentação Oficial
Pergunta da Semana
Qual tarefa repetitiva você faz todo dia que poderia virar uma skill?
Responda este email. Quero saber qual skill vocês mais precisam.
Se tiver demanda, crio e compartilho na próxima edição.
Na Próxima Edição (#07)
Vou compartilhar:
8 técnicas NINJA de Context Window que 99% não conhece
Context budgeting, lazy loading, snapshots
Como trabalhar 8h seguidas sem perder contexto
Até lá! 💪
Adriano Viana
P.S.: Se criar suas skills, me marca no X (@adriano_viana). Vou compartilhar as melhores.