🍳 Skills: receitas reutilizáveis

Pense numa panqueca. Na primeira vez ela queimou. Você anotou na receita: "30 segundos a menos de cada lado". Na segunda saiu boa. Na terceira você nem pensa: segue a receita.

Uma skill funciona assim. É uma receita escrita para o Codex: o que fazer, em que ordem, com que cuidados. A Paula tem uma skill para responder candidatos; o Rui, uma para montar a promoção da semana. Cada correção entra na receita, e a próxima vez sai melhor.

Como ler o desenho: a receita (roxo) gera um resultado (azul). Você comenta (cinza), e a seta roxa de baixo leva o comentário de volta para a receita. Sem essa volta, a skill nunca aprende.

Toda skill tem duas partes. No topo, entre duas linhas de três traços (---), ficam os metadados: o nome e uma descrição de quando usar. Embaixo, as instruções, em texto comum.

O detalhe que mais importa: o Codex não lê todas as receitas inteiras o tempo todo. Ele olha só a descrição de cada uma e decide qual serve. Por isso a descrição precisa dizer, com clareza, em que situação a skill entra.

Como ler o desenho: a faixa roxa é a "etiqueta" da receita, e é tudo o que o Codex olha para saber se ela serve. A faixa azul só é lida quando a skill é escolhida. Etiqueta vaga = receita esquecida na gaveta.

---
name: descricao-post
description: Use quando eu pedir a descrição de um post, de uma gravação ou de um material para o LinkedIn. Escreve um texto curto de apresentação no meu tom.
---

# Regras
- De 2 a 4 frases. Sem tópicos. Sem travessão.
- Tom próximo e profissional, como quem conversa com um gestor de RH.
- Termine com uma pergunta simples para o leitor.

# Passos
1. Leia o rascunho ou a transcrição que eu passar.
2. Ache o tema central em uma frase.
3. Escreva a descrição seguindo as regras.
4. Mostre o texto e pergunte se quero ajustar algo.

O jeito mais fácil não é escrever a skill do zero. É fazer a tarefa uma vez com o Codex, ajustar até ficar do seu gosto e, no fim, pedir: "transforme isso numa skill". Ele já viu o que deu certo e escreve a receita a partir daí.

O Rui fez assim com a promoção da semana. Na segunda-feira, levou meia hora de idas e vindas até o texto ficar bom. No fim, pediu a skill. Na segunda seguinte, a promoção saiu em dois minutos.

Como ler o desenho: a conversa da esquerda tem o "trabalho sujo" das correções. O funil roxo destila só o que importa, e à direita sai a receita limpa, pronta para a próxima semana.

A tarefa que fizemos agora ficou do jeito que eu queria. Transforme-a numa skill deste projeto, em .agents/skills/<nome-curto>/SKILL.md. No topo, entre linhas de ---, coloque name e uma description dizendo em que situação usar. Embaixo, escreva as regras (inclua todas as correções que eu fiz) e os passos em ordem. Mostre o arquivo antes de salvar.

Existem dois jeitos de usar uma skill. O primeiro é só pedir, em português: "faça a descrição deste post". O Codex compara o pedido com as descrições das skills e escolhe a que encaixa.

O segundo é chamar pelo nome, com uma barra na frente: /descricao-post. É o jeito garantido, porque você não deixa a escolha com ele. Use quando tiver muitas skills parecidas ou quando quiser ter certeza.

Como ler o desenho: pelo caminho azul (texto), o Codex usa a lupa para achar a skill certa entre várias. Pelo caminho roxo (barra), você aponta a skill e ele nem precisa procurar. Os dois chegam à mesma receita.

Nenhuma skill nasce perfeita. A diferença está no hábito: toda vez que o resultado não sair do jeito que você quer, em vez de só corrigir aquele texto, você corrige a receita.

A Paula notou que as respostas aos candidatos saíam formais demais. Disse: "gostei da estrutura, mas o tom ficou frio; atualize a skill para usar o primeiro nome do candidato e uma frase de agradecimento". Desde então, todas saem assim.

Como ler o desenho: cada degrau é uma versão da mesma skill. O que faz subir é o comentário em amarelo, transformado em regra. Não é preciso começar no topo: é preciso subir um degrau por vez.

Sobre o texto que você acabou de fazer: gostei de <o que ficou bom>. Não gostei de <o que ficou ruim>. Atualize a skill que você usou para que isso não se repita. Mostre só as linhas que mudaram no SKILL.md, antes e depois.

Quando você tem algumas skills, elas começam a trabalhar juntas. A saída de uma vira a entrada da outra. Você faz um pedido grande e o Codex usa várias receitas em sequência.

A Paula grava uma conversa de dez minutos sobre entrevistas de emprego. Pede: "a partir desta transcrição, faça a descrição, o post do LinkedIn e um artigo com imagens". O Codex usa três skills, uma depois da outra. No fim, ela pergunta "que skills você usou?" e ele lista as três.

Como ler o desenho: a esteira ciano carrega o material de estação em estação. Cada caixa roxa é uma skill que você já tinha criado e melhorado separadamente. Juntas, viram um fluxo de trabalho inteiro.

O que olhar na tabela: cada skill da última coluna funciona sozinha. Crie e acerte uma por vez; só depois peça o fluxo inteiro.