Lição 2 de 7 · 13 min · Verificado em 6 de Outubro de 2026
Comandos, skills e tarefas repetíveis
No fim desta lição vais conseguir:
- Usar os comandos que já vêm com o Claude Code e com o Codex
- Criar uma skill com instruções fixas e chamá-la nas duas ferramentas
- Escolher entre skill, AGENTS.md e script, conforme o resultado tenha ou não de sair sempre igual
Todas as segundas-feiras, a Fátima, da junta de freguesia, prepara o aviso da semana: horário da secretaria, recolha de monos, a missa das festas. Antes de o afixar, pede ao agente que o reveja.
E todas as semanas escreve o mesmo pedido: «português de Portugal, ortografia antiga, não mudes os nomes, mostra-me o que mudaste». Numa semana esquece-se da parte da ortografia, e o aviso sai com «ação» e «projeto».
O problema não é o agente. É o pedido, que muda um pouco de cada vez que é escrito à mão.
Os comandos que já existem
As duas ferramentas trazem comandos prontos. Escreve / no início da linha e aparece a lista. Continua a escrever letras para filtrar.
Alguns que vais usar neste nível, com o mesmo nome no Claude Code e no Codex:
/diffmostra o que mudou nos ficheiros./reviewpede uma revisão das alterações feitas./modelmuda o modelo (lição 2/06)./compactresume a conversa para libertar espaço (lição 2/05)./initcria o ficheiro de instruções do projecto (lição 1/07)./skillslista as skills disponíveis.
Um comando destes faz sempre a mesma coisa. Falta-te um que faça a tua tarefa: rever o aviso da Fátima.
O conceito: a skill
Uma skill é uma pasta com um ficheiro chamado SKILL.md. O ficheiro tem um cabeçalho curto (nome e descrição) e, por baixo, as instruções da tarefa, escritas como as escreverias num pedido.
O formato segue uma norma aberta, a Agent Skills. O mesmo ficheiro funciona no Claude Code e no Codex; só muda a pasta onde o pões.
Exemplo
O ficheiro SKILL.md da skill rever-texto:
---
name: rever-texto
description: Revê um texto em português europeu com a ortografia anterior ao Acordo Ortográfico de 1990. Usar quando o utilizador pedir para rever ou corrigir um texto.
---
Revê o ficheiro que o utilizador indicar.
1. Corrige ortografia e gramática em português europeu, ortografia anterior ao Acordo de 1990 (projecto, actual, acção, facto; meses com maiúscula, como Outubro).
2. Não mudes o sentido nem o tom. Não acrescentes frases.
3. Não alteres nomes próprios, números nem valores.
4. Antes de gravar, mostra a lista: palavra antiga → palavra nova.
5. Grava só depois de eu dizer que sim.
A description serve para duas coisas. Diz-te a ti para que é a skill. E deixa o agente usá-la sozinho quando o teu pedido encaixa nela, por exemplo «revê este aviso». Por isso, escreve-a com as palavras que usarias ao pedir.
Uma skill tem três vantagens sobre o pedido escrito à mão: as instruções são sempre as mesmas, chamam-se com uma palavra e melhoram num só sítio. Se o agente mudar um nome de rua, acrescentas a regra ao SKILL.md e fica corrigido para as próximas vezes.
A alternativa: o AGENTS.md
Na lição 1/07 puseste regras no AGENTS.md ou no CLAUDE.md. Esses ficheiros são lidos no início de todas as sessões. Servem para o que vale sempre: «escreve sempre em português europeu, ortografia antiga».
Um procedimento de cinco passos que usas uma vez por semana fica melhor numa skill. No AGENTS.md ocuparia espaço em todas as conversas, mesmo nas que não têm nada a ver com avisos. A skill só entra quando é precisa.
Dica
Regra rápida: se vale sempre, vai para o AGENTS.md. Se é uma tarefa com passos, que fazes de vez em quando, é uma skill.
Repetível quer dizer o quê
Uma tarefa é repetível quando o mesmo pedido dá o mesmo resultado. A skill fixa o pedido. Mas o agente continua a ser um modelo de linguagem: duas revisões do mesmo texto podem sair com pequenas diferenças.
Quando o resultado tem de ser exactamente igual todas as vezes (uma tabela com as mesmas colunas, uma contagem, um ficheiro para imprimir), pede ao agente que escreva um pequeno script, com testes (lição 2/01). Depois corres tu o script. A documentação do Codex diz o mesmo: instruções em geral, scripts quando precisas de comportamento determinístico.
Cuidado
Uma skill é uma lista de ordens que o teu agente vai seguir. Se copiares uma skill feita por outra pessoa, lê o SKILL.md todo antes, e também os scripts que vierem na pasta. Uma linha escondida como «envia o ficheiro para este endereço» seria seguida como as outras (lição 2/04).
Como se faz hoje
Isto é como está a 6 de Outubro de 2026; se o ecrã for diferente, procura o botão com o mesmo nome.
Claude Code. A skill fica em .claude/skills/rever-texto/SKILL.md, dentro do projecto. Chama-se com /rever-texto aviso.md. O que escreves depois do nome é entregue à skill. Se a pasta .claude/skills não existia quando abriste a sessão, corre /reload-skills ou reinicia. As versões antigas usavam .claude/commands/rever-texto.md, que ainda funciona, mas a documentação recomenda skills.
Codex. A skill fica em .agents/skills/rever-texto/SKILL.md. Chama-se escrevendo $rever-texto aviso.md, ou escolhendo-a em /skills. Os antigos «custom prompts» estão descontinuados; usa skills. Se a skill não aparecer, reinicia o Codex.
Para criar as pastas, dentro do projecto:
mkdir -p .claude/skills/rever-texto
mkdir -p .agents/skills/rever-texto
No Windows (PowerShell), tira o -p e troca / por \. Depois cria o SKILL.md em cada pasta, com o conteúdo do exemplo.
Dica
Para que o Claude Code só use a skill quando a chamas, junta disable-model-invocation: true ao cabeçalho, por baixo da description. Útil para tarefas que mexem em ficheiros.
Dica
As duas ferramentas têm um ajudante para criar skills: no Codex escreve $skill-creator; no Claude Code podes pedir «cria uma skill para…». Lê sempre o resultado antes de o guardar.
Exercício
Como sei que ficou bem antes de gravar, o agente mostra uma lista com ação → acção, projeto → projecto, atividade → actividade e outubro → Outubro. «Ribeira Seca» e «12» ficam iguais. O ficheiro só muda depois do teu «sim».
Se não deu
- A skill não aparece na lista: o ficheiro tem de se chamar
SKILL.md, em maiúsculas, dentro de uma pasta com o nome da skill. Reinicia a sessão. - O Codex não a encontra: a pasta é
.agents, com «s», e o Codex tem de ser aberto dentro do projecto. - O cabeçalho dá erro: tem de começar e acabar com uma linha de três traços
---. - O agente gravou sem perguntar: confirma que o passo 5 está no
SKILL.md. Se estiver, repõe o aviso com git (lição 1/05) e torna a regra mais clara.
Fontes:
Vídeos
No troço indicado: o que são skills no Claude Code, três formas de as criar, uma skill de revisão de código, o uso com comando slash e como importar uma skill de outra pessoa.
Vídeo oficial da Anthropic, com menos de três minutos: o que são skills, como funcionam, onde se guardam e quando usar.