🧩 Skills — habilidades empacotadas
Seu Jarvis ja tem maos (ferramentas) e uma alma (identidade). Falta dar a ele receitas: passos-a-passo que voce nao precisa repetir toda vez. Isso e uma skill — um arquivo de texto que empacota "como fazer tal coisa". Neste modulo voce vai entender o que e uma skill, por que vale empacotar, como elas economizam memoria, em que diferem de uma ferramenta, como rodam em mais de um programa e como melhoram sozinhas.
📒 O que e uma skill
Imagine uma receita de bolo guardada numa pasta. Ela nao e o bolo, nem o forno, nem a farinha — e o passo-a-passo que diz, na ordem certa, o que fazer com tudo isso. Uma skill (habilidade) e exatamente isso para o seu Jarvis: um arquivo de texto que empacota um procedimento repetido. Quando voce diz "escreve um post de LinkedIn", a skill correspondente ja sabe a sequencia — pesquisar o tema, montar um grafico, escrever a copy, revisar e publicar — sem voce reexplicar cada etapa.
Novo aqui? Uma skill e uma "receita reutilizavel" guardada num arquivo de texto chamado SKILL.md. O .md e so a extensao de Markdown — texto simples com titulos e listas, que qualquer pessoa le e edita no bloco de notas. Nao e programa, nao precisa instalar nada: e instrucao escrita que o Jarvis segue.
🧩 Anatomia de uma skill
Toda skill tem duas partes: um cabecalho curto (o "rotulo" da receita, com nome e quando usar) e o corpo (o passo-a-passo de verdade). O cabecalho fica sempre a vista; o corpo so e lido quando a receita e chamada.
- •Nome — como a skill se chama (ex.:
post-linkedin). - •Descricao — uma frase dizendo quando acionar (e o que faz o Jarvis decidir usa-la).
- •Passos — a receita em si: faca isto, depois aquilo, com este criterio.
A grande sacada e que uma skill e conhecimento que vira capacidade. Voce ensina o procedimento uma vez, por escrito, e ele fica disponivel para sempre — em qualquer conversa, sem voce ter que lembrar dos detalhes. E porque e so texto, voce le, edita e versiona como qualquer documento.
Conceitos-chave
Uma receita: passo-a-passo empacotado num arquivo de texto.
O arquivo Markdown que guarda nome, descricao e passos.
Texto simples, legivel por humano, sem programar nada.
Voce escreve o procedimento uma vez; ele vira habilidade permanente.
📦 Por que empacotar
Sem skills, voce vira um disco riscado: toda vez que pede a mesma coisa, precisa reexplicar os 5 passos. "Pesquisa o assunto, mas use so fontes de 2025; depois faz um grafico simples; a copy tem que ter no maximo 3 paragrafos; revise o tom; e so entao publica." Repetir isso a cada pedido cansa voce, e o resultado sai diferente cada vez, porque a explicacao nunca e identica.
✗ Sem skill (explicar toda vez)
- ✗Voce redigita os mesmos passos a cada pedido.
- ✗O resultado varia: as vezes esquece a revisao, as vezes o limite de paragrafos.
- ✗Conhecimento mora so na sua cabeca — ninguem mais reusa.
- ✗Melhorar o processo significa lembrar de mudar a explicacao da proxima vez.
✓ Com skill (uma frase basta)
- ✓Voce diz "faz um post de LinkedIn" e os passos rodam sozinhos.
- ✓O resultado e consistente: a mesma receita, sempre.
- ✓A receita esta num arquivo — da pra compartilhar com a equipe.
- ✓Melhorou? Edita o arquivo uma vez e vale para sempre.
📊 Tres ganhos concretos de empacotar
- •Consistencia: a mesma qualidade toda vez, porque o passo-a-passo nao muda.
- •Velocidade: uma frase no lugar de um paragrafo de instrucoes.
- •Acervo: cada skill que voce escreve fica na prateleira — vira uma biblioteca de capacidades.
Conceitos-chave
Guardar um procedimento repetido num arquivo, em vez de na sua memoria.
A mesma receita produz o mesmo padrao de resultado.
Sua biblioteca de habilidades cresce e se reusa.
Melhoria fica no arquivo e vale para todos os usos futuros.
🔎 Carregamento progressivo
Aqui esta o truque que faz skills serem baratas. Lembre que o LLM tem uma memoria de trabalho limitada — a janela de contexto (vimos isso na Trilha 1). Se voce despejasse o texto completo de 50 skills nessa memoria, ela entupiria antes mesmo de comecar. A solucao e o carregamento progressivo (em ingles, progressive disclosure): o Jarvis so ve, o tempo todo, o rotulo de cada skill — nome e descricao, algo como ~100 tokens. O corpo pesado (a receita inteira) so e lido quando aquela skill e realmente acionada.
Novo aqui? Frontmatter e o cabecalho no topo do arquivo (nome + descricao), entre duas linhas de tres tracos ---. Token e o pedacinho de texto que o modelo conta como "memoria gasta". Progressive disclosure = "revelar aos poucos": mostra so o rotulo ate precisar do conteudo. E como o indice de um livro: voce le os titulos dos capitulos e so abre o capitulo que interessa.
A esquerda, a biblioteca guarda dezenas de skills mas so expoe o rotulo de cada uma (barato). Quando voce aciona uma, o corpo completo da receita entra na memoria de trabalho — so essa, so na hora. E assim que ter muitas skills nao entope o contexto.
Conceitos-chave
Revelar so o rotulo ate a skill ser acionada.
O cabecalho leve (nome + descricao) sempre a vista.
O custo minusculo de manter uma skill disponivel.
Dezenas de skills sem entupir a memoria de trabalho.
🔧 Skills x ferramentas
Cuidado para nao confundir os dois, porque os nomes vivem juntos. No modulo anterior (3-3) voce viu ferramentas: as "maos" do Jarvis — buscar na web, ler um arquivo, mandar um e-mail. Uma ferramenta e uma acao atomica: faz uma coisa e devolve o resultado. Uma skill e outra camada: e um procedimento que decide quais ferramentas chamar, em que ordem, e o que fazer com cada resultado. A ferramenta e o verbo; a skill e a receita que usa varios verbos.
🍳 A metafora da cozinha
Numa cozinha, as ferramentas sao a faca, o forno e a batedeira — cada uma faz uma acao. A skill e a receita do bolo: "bata os ovos (batedeira), corte a fruta (faca), asse 40 min (forno)". A receita orquestra as ferramentas com criterio — sabe a ordem, as quantidades e quando algo deu errado.
Sem ferramentas, a receita nao tem com o que trabalhar. Sem a receita, voce tem ferramentas soltas e nenhum bolo.
🔨 Ferramenta = acao atomica
- •"buscar na web", "ler arquivo", "enviar e-mail".
- •Faz uma coisa e retorna um resultado.
- •Nao decide nada sozinha — alguem precisa chama-la.
- •Costuma chegar via MCP (o "USB" das ferramentas, do modulo 3-3).
🧩 Skill = procedimento + julgamento
- •"escrever post", "fazer resumo do dia", "triar a caixa".
- •Orquestra varias ferramentas, na ordem certa.
- •Aplica criterio: "se nao achou fonte, avise antes de publicar".
- •E so texto (SKILL.md) — nao instala nada, so descreve o como.
Resumindo: ferramenta responde "o que posso fazer" (uma acao). Skill responde "como eu faco tal coisa bem feita" (um procedimento com julgamento, usando varias acoes). Uma skill quase sempre usa ferramentas — mas nem toda ferramenta vira skill.
Conceitos-chave
Uma ferramenta faz uma so coisa e devolve o resultado.
A skill encadeia ferramentas na ordem e com criterio.
A skill decide o que fazer quando algo foge do esperado.
Ferramenta = verbo; skill = receita que usa varios verbos.
🔁 Portabilidade (polyskill)
Porque uma skill e so um arquivo de texto seguindo um formato combinado (a Agent Skills spec), ela nao fica presa a um programa. A mesma receita pode rodar no Claude Code e no Codex (dois assistentes de IA diferentes) — basta uma ferramenta chamada polyskill que pega uma fonte unica e gera a versao certa para cada um. Voce escreve a skill uma vez; ela vale em mais de um lugar.
Novo aqui? Agent Skills spec e so um "formato combinado" — um padrao de como escrever o arquivo de skill, para que programas diferentes saibam le-lo. Polyskill e o tradutor: de uma fonte unica, ele emite (gera) a versao para cada programa. Cross-runtime = "roda em mais de um ambiente de execucao". Portabilidade = a propriedade de levar a mesma coisa de um lugar para outro sem reescrever.
⚠️ Honestidade: o que "multiplos modelos" NAO quer dizer aqui
Quando se fala que skills funcionam com "multiplos modelos", isso e portabilidade (a mesma receita roda em Claude Code e Codex) — e nao um conselho de varios cerebros opinando juntos, nem uma recomendacao de qual modelo escolher. Portabilidade = um arquivo, varios destinos. Nada de votacao magica entre modelos. (Voltamos a esse mito no modulo 3-6, sobre Cerebros.)
Objetivo: criar uma skill minima e portavel — um SKILL.md com cabecalho (nome + descricao) e os passos da receita. Depois geramos a versao para outro programa com o polyskill.
1) Crie a pasta e cole o conteudo abaixo no arquivo SKILL.md (troque as partes <...>):
mkdir -p ~/.jarvis/skills/<nome-da-skill> cat > ~/.jarvis/skills/<nome-da-skill>/SKILL.md <<'EOF' --- name: <resumo-do-dia> description: Use quando eu pedir um resumo do meu dia. Le a agenda e os e-mails nao lidos e devolve 3 bullets curtos. --- # Resumo do dia Passos: 1. Buscar os compromissos de hoje na agenda. 2. Listar os e-mails nao lidos das ultimas <24h>. 3. Resumir em <3> bullets curtos, do mais urgente ao menos. 4. Se nada for urgente, dizer "dia tranquilo" e parar. EOF
2) (Opcional) Gere a versao para outro programa, a partir dessa fonte unica:
polyskill build ~/.jarvis/skills/<nome-da-skill> --target codex
Como verificar: rode cat ~/.jarvis/skills/<nome-da-skill>/SKILL.md e confira que o arquivo abre com ---, tem name: e description:, e depois os passos numerados. No seu Jarvis, peca "me da o resumo do dia" — se ele seguir os 4 passos na ordem, a skill foi reconhecida. Se voce rodou o passo 2, confira que apareceu uma versao na pasta de saida do polyskill para o alvo codex.
Observacao didatica: nomes de comandos (polyskill) e caminhos sao ilustrativos do conceito — o importante e a forma do arquivo (cabecalho entre --- + passos). A spec e o formato; o programa so le.
Conceitos-chave
O formato combinado que torna a skill legivel por varios programas.
O tradutor: de uma fonte unica, emite a versao de cada alvo.
A mesma skill roda em Claude Code e em Codex.
"Multiplos modelos" aqui = um arquivo, varios destinos.
🌱 Skills se auto-corrigem
A parte mais bonita: uma skill nao e uma pedra — e algo vivo que melhora com o uso. Cada vez que a receita roda, voce (ou o proprio Jarvis) percebe o que poderia ser melhor: "faltou checar a fonte", "o tom saiu formal demais", "esse passo era desnecessario". Como a skill e so texto, basta editar o arquivo e a proxima execucao ja sai melhor. A receita aprende com a propria pratica.
Roda
A skill executa a tarefa de verdade — gera o post, faz o resumo.
Observa
Voce nota um atrito: faltou um passo, sobrou outro, o resultado pediu ajuste.
Edita o SKILL.md
Voce ajusta o texto da receita — uma linha a mais, um criterio mais claro.
Melhora dali em diante
A correcao vale para todas as proximas execucoes — sem voce ter que lembrar.
📚 A biblioteca de skills e seu acervo de capacidades
Cada skill que voce escreve e refina fica guardada. Com o tempo, voce nao tem "um assistente" — tem um acervo de habilidades afiadas que so cresce. Um Jarvis com 20 skills boas vale muito mais que um modelo cru, porque carrega procedimentos testados na sua realidade.
E porque tudo e texto legivel, esse acervo "sobrevive ao hype": a tecnologia muda, mas suas receitas continuam valendo.
📊 Por que isso e tao poderoso
- •Melhora composta: pequenos ajustes acumulam — a skill de hoje e melhor que a de ontem.
- •Memoria de processo: a licao aprendida fica no arquivo, nao na sua cabeca.
- •Transferivel: uma skill madura pode ser compartilhada com outras pessoas ja afiada.
Auto-checagem (opcional): qual frase descreve melhor o que e uma skill?
Conceitos-chave
Cada run revela um ajuste; editar o arquivo melhora o futuro.
Pequenos refinamentos acumulam ao longo do tempo.
Sua biblioteca de skills afiadas e o que torna o Jarvis seu.
E so texto: vale mesmo quando a tecnologia muda.
🎯 Resumo do modulo
Proximo modulo:
3-5 — Agentes: o loop que trabalha sozinho