Antes de começar
- Claude Code instalado e autenticado
- Uma pasta de projeto de teste
- Editor de texto
Escolha uma tarefa que você repete
Neste exercício, a tarefa é organizar o pedido de um post: público, objetivo, formato, mensagem e ação esperada. Evite colocar criação de imagens, publicação e análise de resultados na mesma skill.
Separe dois pedidos para testar depois: um completo e outro vago. O pedido vago pode ser: preciso divulgar minha consultoria. A skill deve perceber o que falta antes de inventar detalhes.
Crie a pasta da skill no projeto
Na pasta do projeto, crie .claude/skills/briefing-conteudo/ e, dentro dela, um arquivo chamado SKILL.md. Essa localização é a configuração do Claude Code para uma skill restrita ao projeto.
O nome da pasta deve coincidir com o campo name. Outros agentes têm locais de instalação próprios; confira a documentação do cliente antes de reutilizar a pasta.
Escreva instruções pequenas e verificáveis
Cole o exemplo abaixo no SKILL.md. O trecho entre três hífens é o cabeçalho YAML; o restante explica a tarefa. A descrição diz quando usar a skill, e as instruções dizem como conduzir o trabalho.
Este é um exemplo editorial da Agentspedia. Adapte a saída ao seu processo e mantenha dados de clientes fora do arquivo reutilizável.
---
name: briefing-conteudo
description: Organiza pedidos de posts e campanhas em um briefing. Use quando o usuário pedir um briefing de conteúdo ou trouxer uma ideia de post que precisa ser detalhada.
---
# Briefing de conteúdo
1. Identifique público, objetivo, formato, mensagem central, oferta e ação esperada.
2. Se faltar algo essencial, faça até três perguntas curtas. Não invente números, prazos ou benefícios.
3. Escreva o briefing com as seções: contexto, público, objetivo, mensagem, formato, chamada para ação e pendências.
4. Separe informações confirmadas de sugestões.
5. Termine com três critérios para conferir a peça pronta. Não publique conteúdo.Invoque a skill com um pedido completo
Abra o Claude Code no projeto e use a invocação abaixo. Os dados são fictícios e servem para observar a estrutura da resposta.
Confira se o briefing preserva a oferta, não cria descontos e termina com critérios concretos. Por exemplo: o carrossel deve explicar quem pode participar e mostrar onde se inscrever.
/briefing-conteudo Quero um carrossel de 5 telas para divulgar uma aula gratuita de introdução à IA. Público: freelancers iniciantes. Objetivo: inscrições. A aula será online em 12 de novembro, às 19h. O link de inscrição será informado depois.Teste também a ausência de informação
Em uma nova conversa no mesmo projeto, peça apenas: /briefing-conteudo Preciso divulgar minha consultoria. Verifique se a skill pergunta sobre público e oferta em vez de inventar um pacote.
Anote o que falhou. Se perguntou coisas demais, ajuste a prioridade das perguntas. Se inventou um benefício, deixe a regra sobre informações confirmadas mais explícita e repita o mesmo teste.
Guarde uma versão que você consegue repetir
Salve o arquivo junto ao projeto e registre seus dois pedidos de teste. Antes de acrescentar mais regras, confira se a skill já atende a tarefa básica.
Quando quiser compartilhar, envie a pasta com o SKILL.md e explique em qual cliente você conferiu o uso. Não inclua credenciais ou exemplos privados de clientes.
O que você terá ao final
Uma skill pequena para organizar briefings, com dois casos de teste e critérios para melhorar a próxima versão.
Vale conferir
- A skill fornece instruções; não adiciona ferramentas nem garante que o agente sempre as siga.
- O caminho e a invocação mostrados são do Claude Code.
- Tutorial preparado a partir da documentação; o exercício não foi executado pela Agentspedia.