Toda skill nasce do mesmo ciclo: você descreve o workflow em linguagem natural, o agente gera o SKILL.md no formato oficial, ele vira um slash command (ex.: /draft-email), e a partir daí você reusa — de preferência com o contexto limpo, para que cada execução seja previsível.

Diagrama ilustrativo — a caixa azul é o agente escrevendo o SKILL.md. Construir é uma vez; reusar é para sempre. O laço pontilhado é o reuso com /clear entre execuções.

O que é

Construir uma skill começa por um bom pedido. Você descreve o workflow — quais são as entradas, qual o comportamento esperado, e onde salvar o resultado — e pede ao agente para transformar isso num slash command seguindo o formato oficial de skill. É a mesma mentalidade do vibe coding: você diz o "o quê", o agente escreve o SKILL.md (o "como").

Um pedido bom é específico nas três dimensões. Vago demais ("faz uma skill de e-mail") força o agente a adivinhar; específico demais nos passos técnicos ("crie um arquivo .md com YAML frontmatter contendo…") joga fora a vantagem de deixá-lo escolher. O ponto certo: descreva entradas, comportamento e destino — e deixe o resto com ele.

Entre em Plan Mode.

Quero uma skill que .
- Entradas: 
- Comportamento: 
- Onde salvar: 

Crie isso como um slash command seguindo o formato
oficial de skill (SKILL.md com nome, descrição e
instruções). Me mostre o plano antes de gravar.

Por que aprender

Um pedido no formato oficial garante que a skill nasça reutilizável — com nome, descrição e instruções que o agente vai reler toda vez que você invocar. Pedir em Plan Mode te dá um ponto de revisão: você corrige o escopo antes que vire arquivo.

Conceitos-chave

O que é

Vamos construir a primeira skill de verdade: /draft-email. Ela recebe três entradas — os bullets do conteúdo, o destinatário e o tom — e escreve um e-mail polido, conciso, sem enrolação (fluff). O rascunho é salvo numa pasta temporária, e o procedimento inteiro vira o comando /draft-email.

---
name: draft-email
description: Rascunha um e-mail polido a partir de
  bullets, destinatário e tom. Use quando o usuário
  pedir para escrever ou rascunhar um e-mail.
---

# Rascunhar e-mail

## Entradas
- destinatário: para quem é o e-mail
- tom: 
- bullets: os pontos a cobrir

Se faltar alguma entrada, PERGUNTE antes de escrever.

## Comportamento
1. Escreva um e-mail conciso e polido, sem fluff.
2. Respeite o tom pedido; assunto curto e claro.
3. Salve o rascunho em /email.md.

Por que aprender

E-mail é o exemplo perfeito de tarefa repetitiva e padronizável: você faz dezenas por semana, todos seguem a mesma estrutura. Encapsular isso numa skill significa que o "como escrever bem" mora no SKILL.md, e você só fornece o conteúdo. Construa uma vez, ganhe tempo para sempre.

Conceitos-chave

O que é

O teste de robustez de uma boa skill: chame /draft-email sem passar nenhum dado. Em vez de rodar no escuro e inventar um destinatário e um tom, a skill deve perguntar pelas entradas que faltam — destinatário, tom, bullets — antes de escrever uma única linha. Aquela instrução do SKILL.md ("se faltar alguma entrada, PERGUNTE") é o que garante isso.

Diagrama ilustrativo — invocar sem dados não é erro: dispara a coleta. A skill só escreve depois de ter as três entradas.

Por que aprender

Skills que perguntam antes de rodar evitam o pior pesadelo da automação: um resultado plausível mas errado, baseado em chutes. Quando a skill coleta o que falta, você controla a entrada — e nunca recebe um e-mail dirigido à pessoa errada no tom errado.

Você:
/draft-email

Skill (esperado):
Para escrever o e-mail, preciso de:
1) Para quem é? 
2) Qual o tom? 
3) Quais pontos cobrir? 

(a skill NÃO escreve nada até você responder)

Conceitos-chave

O que é

O verdadeiro retorno de construir uma skill aparece no reuso. Para reusar bem, dê /clear (limpa a conversa) e chame /draft-email de novo com novas entradas. O resultado: uma saída fresca e consistente, seguindo as mesmas regras do SKILL.md, sem o lixo da conversa anterior contaminando o novo e-mail.

Por que aprender

Sem contexto limpo, o terceiro e-mail do dia pode herdar o tom do primeiro, ou citar o destinatário errado. Limpar antes de cada reuso torna cada execução previsível — a skill aplica sempre as mesmas regras, partindo sempre do mesmo ponto.

/clear

/draft-email
destinatário: 
tom: 
bullets:
- 
- 
- 

Conceitos-chave

O que é

Uma skill mais ambiciosa, mas montada do mesmo jeito: documento → slides. Ela lê um documento, extrai os pontos-chave e cria uma apresentação profissional usando ferramentas Python. O documento de entrada fica em temporary/resources e a apresentação gerada sai em temporary/outputs — pastas organizadas, entrada separada de saída.

Crie uma skill chamada  que:
- Lê um documento de temporary/resources/
- Extrai os pontos-chave do conteúdo
- Cria uma apresentação profissional usando
  ferramentas Python
- Salva o resultado em temporary/outputs/

Faça no formato oficial (slash command). Se faltar
o arquivo de entrada, PERGUNTE qual usar.

Por que aprender

Essa skill mostra que o mesmo padrão escala: entradas claras, comportamento descrito, destino definido — agora com o agente escrevendo código Python por baixo. Você não precisa saber Python; precisa descrever o resultado. E a separação resources/outputs mantém o projeto limpo e a skill reusável com qualquer documento.

Conceitos-chave

O que é

Skills se compõem. Em vez de descrever cada detalhe visual da sua apresentação, você empilha uma skill de design já existente sobre a skill doc-to-slides. A skill de design carrega as regras de tipografia, cores e espaçamento; a sua skill cuida do conteúdo. O resultado sobe de qualidade visual sem você virar designer.

Diagrama ilustrativo — empilhar uma skill de design não substitui a sua; cada uma cobre uma responsabilidade, e juntas elevam o resultado.

Por que aprender

Composição é o que faz a sua biblioteca de skills valer mais que a soma das partes. Uma skill de design pronta vira um "tema" que você pluga em qualquer skill que gera artefato visual. Você reaproveita conhecimento de design que nem é seu — e o resultado parece feito por especialista.

Conceitos-chave

O que é

Agora que você sabe construir, testar, invocar e reusar, o passo final é acumular: montar a sua biblioteca de skills. Cada skill é uma tarefa repetitiva sua, encapsulada uma vez. Abaixo, um catálogo de ideias prontas — não para copiar, mas para servir de ponto de partida da sua própria coleção.

Catálogo de pontos de partida

O ciclo de vida de uma skill

Por que aprender

Uma biblioteca de skills é capital que rende juros: cada skill que você constrói economiza tempo em toda execução futura, e skills boas se compõem em fluxos maiores. Comece pequeno — uma ou duas skills das suas tarefas mais repetitivas — e deixe a coleção crescer com o uso.

Conceitos-chave