SKILL 02 · AGENT SKILL
Briefing de projeto
Transforma pedido vago em escopo, fontes, formato e critério de aceite.
O QUE ESTA SKILL VERIFICA
O que ela coloca na mesa.
DETALHES DA SKILL
Como esta skill funciona na prática.
Entenda a função, o melhor cenário de uso e o resultado que você deve revisar antes de incluir esta skill no seu fluxo de trabalho.
Quando ela é útil
Pesquisa, conteúdo, desenvolvimento e automações com escopo ainda vago.
O que ela faz
Transforma pedido vago em escopo, fontes, formato e critério de aceite.
O que você deve receber
Briefing curto, auditável e pronto para orientar a próxima tarefa.
Onde pode ser usada
Claude Code, Codex e agentes compatíveis com arquivos SKILL.md.
Esta skill orienta o agente por meio de um arquivo SKILL.md. Ela não executa comandos sozinha e o resultado ainda precisa de revisão humana.
ANÁLISE EDITORIAL
Por que um briefing melhora a resposta da IA
Pedidos vagos fazem o agente preencher lacunas com suposições. Um briefing curto reduz esse problema ao declarar o resultado esperado, o público, as fontes disponíveis, as restrições e o critério de aceite. Ele não precisa antecipar toda a solução, mas deve deixar claro o que pode e o que não pode acontecer.
O núcleo do briefing
- Resultado: descreva a decisão, o arquivo ou a mudança que precisa existir ao final.
- Contexto: informe para quem é o trabalho, onde será usado e o que já foi decidido.
- Escopo: liste itens incluídos, exclusões e ações que dependem de autorização separada.
- Evidência: indique documentos, URLs, dados e versões que devem sustentar o trabalho.
- Aceite: defina como será possível verificar que a entrega está correta.
Exemplo de uso responsável
Em vez de pedir “melhore meu site”, informe quais páginas estão no escopo, qual problema foi observado, quais métricas ou políticas precisam ser atendidas e quais alterações podem ser publicadas. Se houver risco de excluir dados, enviar mensagens ou alterar produção, mantenha essas ações fora do briefing inicial até uma confirmação explícita.
O documento produzido por esta skill deve ser revisado antes de orientar a execução. Números, prazos e requisitos não fornecidos devem aparecer como lacunas ou hipóteses, nunca como fatos inventados. Um bom briefing cria um ponto comum de entendimento e facilita comparar a entrega com o pedido original.
CONFIGURAÇÃO
Instale só depois de ler.
Baixe o ZIP, abra o arquivo SKILL.md e confira se o conteúdo faz sentido para o seu uso.
Abra o print e o README
- Confira mantenedor e nome do repositório.
- Leia licença, requisitos e permissões.
- Escolha uma versão ou commit para aprovar.
Comece em um projeto de teste
- Use o comando acima ou o método do README.
- Prefira instalação por projeto antes da global.
- Não copie tokens, chaves ou arquivos sensíveis.
Faça um teste pequeno
- Confirme a descrição e os arquivos instalados.
- Execute uma tarefa reversível.
- Registre versão aprovada e remova o que não usar.