🎯 O que é uma Skill
Uma skill é um pacote de instrução durável + recursos. Vive em disco. Sobrevive entre sessões. É invocável por nome. É a forma de transformar uma rotina que funciona em algo reusável.
Prompt
Instrução que vive na sessão. Some quando você fecha o chat. Útil pra exploração.
Tool
Conexão técnica para uma API ou função. Read, Bash, WebFetch. O agente usa quando precisa.
Skill
Pacote de instrução + recursos. Vive em disco, é versionada, invocada por nome em qualquer sessão.
📌 A diferença que importa
Você descobre que pedir "abre PR seguindo template + adiciona Co-Authored-By + roda gh pr create" funciona muito bem. Sem skill: cola o prompt toda vez. Com skill: vira `pr-creator` e você invoca em 1 palavra. Multiplicado por 50 rotinas, é uma vida diferente.
📦 Anatomia: SKILL.md, references/, scripts/
Toda skill tem o mesmo layout: arquivo principal SKILL.md (instrução + frontmatter), pasta references/ (docs longas) e pasta scripts/ (executáveis auxiliares).
📁 Estrutura de uma skill
---
name: landing-page
description: Gera uma landing page completa para PME brasileira em 1 hora — hero, pricing, depoimentos, FAQ, CTA. Use quando o usuario disser "preciso de uma landing", "site de venda", "pagina de captacao".
when_to_use: Pedido para criar landing page, site institucional, pagina de produto, MVP de captacao.
---
# Landing Page Skill
Voce gera uma landing page production-ready em 1 hora.
## Passos
1. Reverse prompt: pergunta nicho, oferta, preco, prova social.
2. Gera HTML usando o template em `assets/template-base.html`.
3. Para copy, leia `references/copy-templates.md`.
4. Para design system, leia `references/design-system.md`.
5. Roda `scripts/scaffold.sh` para criar pasta e abrir browser.
## Definition of Done
- Lighthouse > 90 em mobile.
- Smoke test em viewport 375px e 1440px.
- CTA testado (link funciona).💡 O frontmatter é o que vende
O agente vê só o frontmatter antes de decidir invocar a skill. Se a `description` é vaga, o agente ignora. Se o `when_to_use` lista gatilhos verbais reais ("preciso de landing", "site de venda"), a skill é puxada na hora certa.
🪜 Progressive Disclosure
Skills carregam só o que precisam, no momento que precisam. Isso é o que permite ter 50 skills disponíveis sem queimar a janela de contexto.
🪜 Os 3 níveis de carregamento
❌ Sem progressive disclosure
10 skills × 3000 tokens cada = 30k tokens antes da primeira mensagem.
A janela de contexto vira lixo. O agente fica burro com sobrecarga.
✅ Com progressive disclosure
10 skills × 50 tokens visíveis = 500 tokens. Carrega o resto sob demanda.
Você pode ter 100+ skills sem custo perceptível.
📌 Implicação prática
Não tenha medo de instalar skills. Skill que não é usada custa 50 tokens — equivalente a uma frase. Skill que é usada paga seu custo facilmente. Mantenha sua biblioteca rica.
🛒 Instalar Skills da Loja Oficial
A loja oficial da OpenAI tem skills prontas, otimizadas e mantidas. Antes de criar skill própria, sempre cheque a loja. Reinventar dá retrabalho e raramente é melhor.
| Skill oficial | Para quê | Quando usar |
|---|---|---|
| browser-use | Navegar sites, preencher formulários, scrapear dados. | QA visual, scraping de concorrente, validação de fluxo de produto. |
| computer-use | Controlar a tela inteira (mouse, teclado, screenshots). | Automatizar app desktop, demos, testes E2E em apps nativos. |
| remotion | Gerar vídeos com React. Animação programática. | Vídeo de venda, social media, demo animado, intro de curso. |
| canvas-design | Criar PDF e PNG com design profissional. | Pitch deck, poster, capa de e-book, mídia kit. |
| excalidraw-diagram | Gerar diagramas de arquitetura em Excalidraw. | Documentação técnica, fluxograma de processo, mind map. |
$ codex skills browse
→ abre marketplace no app
$ codex skills install browser-use
✓ baixando de openai/skills/browser-use@2.1.0
✓ verificando assinatura
✓ instalado em ~/.codex/skills/browser-use/
$ codex skills list
browser-use v2.1.0 oficial
computer-use v1.4.0 oficial
landing-page v1.0.0 master-codex💡 Critério de instalação
Instalou e não usou em 30 dias? Desinstala. Skills oficiais são gratuitas mas atenção do agente é cara. Mantenha a biblioteca enxuta — cada skill ali deve resolver problema real e recorrente.
👆 Invocação: Manual vs Automática
Skills podem ser invocadas automaticamente (o agente reconhece o gatilho) ou manualmente (você força com @nome-da-skill). Cada modo serve a um cenário.
🤖 Automática
Você diz: "preciso de uma landing pra clínica de estética".
O agente lê o `when_to_use`, reconhece "landing" como gatilho, carrega landing-page sozinho.
👆 Manual
Você diz: "@landing-page clínica de estética em SP, R$ 297/mês".
A skill é carregada obrigatoriamente, sem depender do agente reconhecer.
⚖️ Trade-offs
| Critério | Automática | Manual (@nome) |
|---|---|---|
| Fluidez | +++ | + |
| Garantia de uso | + | +++ |
| Scriptável | não | sim |
| Funciona com skill nova | precisa polir gatilho | sempre |
📌 A regra prática
Use automática no dia a dia (chat fluido). Use manual em automações (scripts, hooks, CI). Quando criar skill nova, comece manual até ajustar o gatilho — depois libere para automática.
🎁 As 5 Skills do Master Codex
Cinco skills proprietárias entregues no curso. Foram desenhadas pra tirar você do zero a entregar projeto vendável. Sozinhas, justificam o investimento de R$ 5k.
🚀 Landing Page Completa
Hero, pricing, depoimentos, FAQ, CTA. Lighthouse 90+. Pronta pra ar.
🔍 Auditoria de PR
Roda na PR aberta. Aponta bugs, segredos vazados, lógica frágil, sugere melhorias.
📸 QA Visual Automatizado
Screenshots desktop+mobile, comparação antes/depois, lista de regressões visuais.
💼 Kit Completo de Micro-SaaS
Landing + auth + Stripe + dashboard + email transacional. Do zero ao primeiro cliente pagante.
📊 Relatório Semanal de Cliente
Lê commits da semana, métricas do banco, abre tickets fechados. Gera PDF/email com o que foi entregue. Justifica os R$ 2k/mês de retainer sem você escrever uma linha.
💡 Por que essas 5
Cada skill resolve um problema que todo freelancer/dev solo encara semanalmente: vender (landing), revisar (PR review), garantir qualidade visual (QA), lançar produto (micro-SaaS), justificar valor pro cliente (weekly report). Não são exemplos didáticos — são alavancas comerciais.
✅ O que Aprendemos
Próximo Módulo:
2.3 — Reverse prompting + Plan Mode + Definition of Done. Os três hábitos que separam quem entrega na primeira tentativa de quem itera 10 vezes.