Skills

seu superpoder no Claude Code

Workshop Carrot · 15/04/2026 · Antonio Castelo

Antes de explicar o que é,
quero te mostrar funcionando.

O que
aconteceu?

Vamos desmontar o truque

Uma skill é literalmente um arquivo de texto

~/.claude/skills/carrot-voice/SKILL.md
--- name: carrot-voice description: Revisa qualquer texto aplicando a voz da Carrot. Use quando o usuário pedir revisão de e-mail, post, legenda ou copy. --- # Revisar texto no tom da Carrot Antes de revisar, leia os arquivos: - .claude/rules/brand.md - context/brand/glossary.md Depois, devolva: 1. O texto revisado 2. Lista das mudanças que você fez e por quê
Claude lê esse arquivo como se fosse você dando instrução no chat — só que reutilizável, em qualquer conversa.

Onde as skills moram

Localização Caminho Quem usa
Pessoal ~/.claude/skills/nome/SKILL.md Só você, em todos os projetos
Projeto .claude/skills/nome/SKILL.md Todo mundo que abrir esse projeto
Plugin Via plugin instalado Onde o plugin estiver ativo
Empresa Managed settings Time inteiro
No workspace Carrot-AI, a pasta .claude/skills/ já tem skills compartilhadas — /daily-checkin, /daily-checkout, /ideate. Essas são skills de projeto.

Como o Claude sabe quando usar

1. Você chama

  • Digita /carrot-voice no chat
  • Autocomplete mostra a skill
  • Enter — skill é invocada

2. Claude decide sozinho

  • Você escreve "revisa esse texto pra mim"
  • Claude lê o description da skill
  • Se bater com o pedido, invoca automaticamente
A description é o que faz Claude decidir. Quanto mais específica, melhor ele escolhe. "Revisa texto aplicando voz da Carrot" é muito melhor que "Skill de texto".

Chat · Projeto · Skill · Agente · MCP

O mapa mental que todo mundo pediu pra ser esclarecido

Chat Projeto Skill Agente MCP
O que é Conversa única Conversa com contexto fixo Playbook invocável Skill + ferramentas + identidade Ponte pra ferramenta externa
Mora Na sessão No Claude.ai (app web) .claude/skills/ .claude/agents/ .mcp.json
Reutilizável? Não Sim, dentro do projeto Em qualquer lugar Sim Sim
Exemplo "Me ajuda com esse e-mail" Projeto "Newsletter" /carrot-voice code-reviewer Notion, Gmail, Granola
Ponto-chave: "Projeto" é dentro do Claude.ai (app web do navegador). "Skill" é no Desktop + sistema de arquivos — roda em qualquer sessão, em qualquer lugar.

Anatomia do SKILL.md

Frontmatter YAML

  • name → vira o slash command
  • description → Claude usa pra decidir ativação
  • Outros campos opcionais: allowed-tools, argument-hint

Corpo markdown

  • Instruções que Claude segue quando a skill é invocada
  • Pode referenciar outros arquivos
  • Quanto mais claro, melhor o resultado
Se você já sabe escrever um prompt bom, você já sabe escrever uma skill. A diferença é que agora ele fica salvo e reutilizável.

Skills podem ler outros arquivos

A parte mais poderosa. A skill do cold open referenciou o brand.md e o glossary.md — isso é o que permitiu ela revisar no tom Carrot sem a gente precisar copiar as regras pro arquivo dela.

Metáfora: é como se a skill dissesse "antes de me executar, vai ler esses arquivos". Você não precisa colar o contexto — só aponta pra onde ele já está.

Exemplos que você pode referenciar hoje

  • .claude/rules/brand.md — regras de voz e tom da Carrot
  • context/brand/glossary.md — termos e nomenclatura oficial
  • context/company.md — o que a Carrot é, missão, produtos
  • Qualquer arquivo seu no workspace

Skills podem até rodar código

Skills não precisam ser só texto. Elas podem rodar scripts — Python, shell, qualquer coisa — e usar o resultado na resposta.

Exemplos reais: skill que gera visualização do codebase, skill que busca dados no banco, skill que chama uma API externa.

Hoje a gente foca em skills só com texto — é 80% do valor e é o que dá pra aprender em 1h. Mas saiba que dá pra ir muito além quando você se sentir confortável.

Como criar uma skill · 3 caminhos

1. Mais simples Pede pro /skill-creator criar pra você.
Foi o que a gente acabou de ver no cold open. Você descreve o que quer, ele cria o arquivo.
2. Intermediário Cria a pasta manualmente em ~/.claude/skills/nome/ e escreve o SKILL.md no seu editor de texto favorito.
Útil quando você já sabe o que quer e prefere escrever direto.
3. Avançado Cria skill de projeto em .claude/skills/ dentro do workspace Carrot-AI — pra compartilhar com o time inteiro.
Só Engineering commita no compartilhado, mas qualquer um pode pedir pra virar skill de projeto.
Hoje vocês vão usar o caminho 1. É o mais rápido pra ver a mágica acontecer.

Boas práticas rápidas

  • Descrição específica — não "skill de texto", mas "revisa texto aplicando voz da Carrot"
  • Começa simples — prefere 5 linhas que funcionam a 50 linhas quebradas
  • Testa com exemplo real — cola um texto de verdade e vê se funciona
  • Referencia contexto que já existe — brand.md, glossary.md, company.md
  • Se repetir 3+ vezes, vira skill — é a regra mais simples

Agora
vai você

Hands-on: criando sua primeira skill

Sua missão

O desafio

Pensa em alguma coisa que você já pediu pro Claude mais de 3 vezes essa semana. Ou algo chato/repetitivo que você faz no trabalho toda semana.

Vamos transformar isso em uma skill.

As regras

  • Útil pro teu dia a dia real (não exemplo fictício)
  • Começa simples — 5 linhas que funcionam ≫ 50 quebradas
  • Usa o /skill-creator no teu Claude Desktop
  • Testa com um caso real antes do show-and-tell

Banco de ideias

Se você travou em "não sei o que criar", começa aqui. Não é obrigatório — é gatilho.

Design /validar-design-pro-marketing /gerar-alt-text
Business /analisar-edital /preparar-reuniao-investidor
Operations /registrar-contato-notion /revisar-email-participante
Marketing /legenda-linkedin-carrot /proposta-newsletter
Product /rascunho-prd /resumir-feedback
Engineering /revisar-pr-critico /escrever-changelog

Como o tempo roda

0–10 min Escolhe a ideia + descreve em 1 frase o que a skill faz
10–30 min Usa o /skill-creator pra gerar + ajusta o resultado
30–40 min Testa com um caso real + chama a gente se quiser revisão
Travou? Engineers na sala são buddies informais. Levantou a mão, a gente senta junto. Ninguém sai sem ter pelo menos uma skill funcionando.

Mostra o que
você criou

Show & tell · 2 minutos por pessoa

Próximos passos

  • 1. Sua skill vai evoluir
    Usa ela essa semana no trabalho real. Quando notar algo pra melhorar, volta no arquivo e ajusta.
  • 2. Compartilha o que funciona
    Se uma skill tua é útil pro time inteiro, Engineering pode transformar em skill de projeto no workspace compartilhado.
  • 3. Canal #carrot-ai no Slack
    Qualquer dúvida de skill, pergunta lá. Engineering responde.

Se você repetir,
vira skill.