Skills são o jeito mais fácil de ensinar a um agente de código algo que ele não faz bem por padrão: um padrão de design, um checklist de revisão, um jeito de economizar tokens. Este guia explica onde as skills ficam no Claude Code e no Codex, como instalar na mão e como gerenciar tudo sem linha de comando.
O que é uma skill?
Uma skill é uma pasta com um arquivo SKILL.md: instruções em Markdown com um nome curto e uma descrição no topo, mais os scripts ou arquivos de referência de que ela precisar. O agente lê as descrições das skills instaladas e só carrega as instruções completas de uma skill quando a tarefa pede, então skills instaladas quase não gastam contexto até serem usadas.
my-skill/
├── SKILL.md
└── scripts/
└── check.sh
Onde o Claude Code e o Codex procuram skills
| Agente | Skills pessoais (todos os projetos) | Skills do projeto |
|---|---|---|
| Claude Code | ~/.claude/skills/<name>/ |
.claude/skills/<name>/ no repositório |
| Codex | ~/.codex/skills/<name>/ ou ~/.agents/skills/<name>/ |
conforme a documentação do Codex |
Se você define CLAUDE_CONFIG_DIR ou CODEX_HOME, as pastas pessoais mudam junto.
Instalando uma skill na mão
- Encontre o repositório da skill e a pasta que contém o
SKILL.mddela. - Copie essa pasta para o seu diretório de skills:
git clone https://github.com/owner/repo /tmp/repo
cp -R /tmp/repo/skills/my-skill ~/.claude/skills/- Abra uma sessão nova do agente para ele enxergar a skill.
Atualizar significa repetir a cópia, e não tem como desfazer se a versão nova der problema, então guarde um backup da pasta antiga.
Só instale skills em que você confia. Uma skill pode trazer scripts que o agente pode rodar com as suas permissões. Leia o SKILL.md e os scripts antes.
Gerencie seus próprios repositórios de skills com o Vibe Console
No painel Skills do Vibe Console, adicione um repositório do GitHub em que você confia, como owner/repo ou https://github.com/owner/repo. Escolha uma seção para o card dele e depois escolha quais skills instalar para o Claude Code ou o Codex. A lista fica salva no seu Mac; o Vibe Console não fornece os arquivos das skills. Você pode tirar qualquer card da lista sem desinstalar o que já instalou.
Atualizações seguras, com rollback
O Vibe Console verifica se as skills instaladas têm atualização e marca com Atualização disponível, ou com A origem é diferente — revise as alterações quando os arquivos no disco não batem mais com a origem. Ao atualizar, ele guarda um backup dos arquivos anteriores. Se a versão nova der dor de cabeça, aperte Reverter, ou Abrir backup para conferir os arquivos antigos.
Perguntas frequentes
As skills funcionam no Claude Code e no Codex?
O formato SKILL.md funciona nos dois, mas cada agente carrega skills da sua própria pasta. Instale a skill para cada agente que você usa.
Skills instaladas deixam o agente mais lento?
Quase nada. Os agentes leem só a descrição curta de cada skill até uma tarefa precisar dela.
Como removo uma skill?
Apague a pasta dela do diretório de skills e abra uma sessão nova.
Teste o painel Skills grátis por 14 dias: baixe o Vibe Console.