Entenda o que uma skill ensina
Separe instrução, ferramenta e resultado antes de automatizar.
O que é
Uma skill é um procedimento reutilizável que orienta um agente em uma tarefa. Na analogia do vídeo, o resultado é a panqueca, o agente é o cozinheiro e a skill é a receita. O arquivo registra decisões que você não quer explicar novamente a cada pedido.
Por que aprender
Sem um procedimento, o agente precisa preencher lacunas: tamanho, formato, fontes e critérios de qualidade. Registrar essas escolhas reduz variações evitáveis. Isso não torna a geração infalível: ingredientes diferentes e ferramentas indisponíveis ainda mudam o resultado.
Conceitos-chave
- Entrada: o material recebido.
- Processo: as ações e decisões.
- Saída: o artefato entregue.
- Aceite: a evidência de que a entrega serve.
O que é
Um prompt pede algo nesta interação. Uma skill guarda um procedimento especializado. AGENTS.md registra orientações duráveis do projeto. Uma ferramenta executa uma capacidade concreta, como ler um arquivo ou consultar um serviço. Essas peças se complementam.
Por que aprender
Quando tudo vai para a regra global, detalhes de uma tarefa passam a influenciar tarefas sem relação. Quando tudo fica no prompt, você repete instruções. Separar os papéis ajuda a encontrar o lugar correto para cada correção.
Conceitos-chave
- Prompt: intenção e dados da execução.
- Skill: método reutilizável.
- AGENTS.md: convenções do projeto.
- Ferramenta: capacidade e acesso.
O que é
O melhor primeiro candidato é uma tarefa frequente com uma definição de bom que você consegue mostrar. Não precisa ser complexa. Uma descrição de vídeo, uma revisão de texto ou um relatório curto já permite aprender o ciclo inteiro.
Por que aprender
Começar por “gerenciar meu negócio” mistura planejamento, escrita, contas e publicação. Você não consegue localizar o erro. Uma tarefa menor produz um artefato avaliável e dá feedback mais rápido, antes de conectar sistemas importantes.
Conceitos-chave
- Frequência: quantas vezes se repete.
- Custo do erro: o que uma falha causa.
- Observabilidade: como reconhecer acerto.
- Escopo: onde a tarefa termina.
O que é
O contrato descreve o que precisa chegar, o que será produzido e o que acontece quando falta informação. No nosso laboratório, o CSV contém data, canal e valor. A saída traz período observado, total, totais por canal e pendências.
Por que aprender
Dados ausentes não devem virar suposições silenciosas. Se “valor” não existe, a skill não consegue calcular faturamento. Uma resposta útil identifica o campo faltante, interrompe apenas a etapa dependente e preserva o material original.
Conceitos-chave
- Pré-condição: dados mínimos.
- Pós-condição: conteúdo obrigatório.
- Invariante: algo que não pode mudar.
- Falha prevista: resposta útil sem inventar.
O que é
Os seis passos são uma proposta prática do autor: partir do resultado, delimitar tarefa, calibrar liberdade, verificar, comparar configurações e incorporar feedback. A expressão “melhor que 99%” é o título promocional da referência, não um resultado medido neste curso.
Por que aprender
O vídeo mostra saídas diferentes entre modelos em uma tarefa visual. Isso é um estudo de caso útil, mas não estabelece um ranking universal. Tempos observados naquela execução também não garantem duração, preço ou qualidade na sua conta.
Conceitos-chave
- Relato não equivale a benchmark.
- Repetibilidade exige vários casos.
- Ferramentas dependem de acesso real.
- Autoavaliação exige evidência.
O que é
Você vai trabalhar com dados sintéticos e arquivos locais. Baixe o kit na página inicial, abra a pasta no Codex e mantenha entrada, saída e evidências separadas. O exercício não exige API paga nem uma conta conectada a CRM.
Por que aprender
Separar pastas torna possível refazer uma execução sem substituir o original. A cada mudança, você consegue comparar o relatório anterior com o novo e verificar se a correção trouxe algum efeito indesejado.
Conceitos-chave
- dados/: entradas imutáveis.
- saidas/: resultados da execução.
- evidencias/: testes e observações.
- SKILL.md: procedimento versionável.