SKILL 02 · AGENT SKILL

Briefing de projeto

Transforma pedido vago em escopo, fontes, formato e critério de aceite.

USE QUANDOPesquisa, conteúdo, desenvolvimento e automações com escopo ainda vago.
ENTREGABriefing curto, auditável e pronto para orientar a próxima tarefa.

O QUE ESTA SKILL VERIFICA

O que ela coloca na mesa.

Decisão ou resultado esperado
Contexto, público e restrições
Escopo incluído e excluído
Fontes, formato e critério de conclusão

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.

PROBLEMA QUE RESOLVE

Quando ela é útil

Pesquisa, conteúdo, desenvolvimento e automações com escopo ainda vago.

FUNÇÃO PRINCIPAL

O que ela faz

Transforma pedido vago em escopo, fontes, formato e critério de aceite.

RESULTADO DA EXECUÇÃO

O que você deve receber

Briefing curto, auditável e pronto para orientar a próxima tarefa.

AMBIENTE COMPATÍVEL

Onde pode ser usada

Claude Code, Codex e agentes compatíveis com arquivos SKILL.md.

Limite importante

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.

01 · CONFIRME A ORIGEM

Abra o print e o README

  1. Confira mantenedor e nome do repositório.
  2. Leia licença, requisitos e permissões.
  3. Escolha uma versão ou commit para aprovar.
02 · INSTALE COM ESCOPO

Comece em um projeto de teste

  1. Use o comando acima ou o método do README.
  2. Prefira instalação por projeto antes da global.
  3. Não copie tokens, chaves ou arquivos sensíveis.
Documentação de skills ↗
03 · VALIDE O RESULTADO

Faça um teste pequeno

  1. Confirme a descrição e os arquivos instalados.
  2. Execute uma tarefa reversível.
  3. Registre versão aprovada e remova o que não usar.
Boas práticas no Codex ↗
← Voltar para todas as skills