O que são Agent Skills?
Agent Skills são pastas com instruções, scripts e arquivos de referência que ensinam um agente a fazer um trabalho específico. Cada skill gira em torno de um arquivo SKILL.md, e o agente só carrega uma skill quando a tarefa em andamento pede.
Como uma skill é estruturada
Uma skill é uma pasta com o nome dela. O frontmatter YAML do SKILL.md guarda os campos name e description, e o corpo traz instruções passo a passo. A pasta também pode levar scripts, templates ou documentos de referência.
- No Claude Code, as skills pessoais ficam em ~/.claude/skills/ e as do projeto em .claude/skills/.
- O Codex também suporta skills: as do projeto ficam em .agents/skills e as pessoais em ~/.codex/skills.
- Plugins também podem trazer skills junto.
Por que as skills carregam aos poucos
No início, só o nome e a descrição curta de cada skill entram no contexto do modelo. Quando uma tarefa combina com uma skill, o modelo lê o SKILL.md completo e, se precisar, os arquivos ao lado. Isso mantém o contexto pequeno mesmo com dezenas de skills instaladas, mas uma skill com descrição vaga não vai entrar em ação no momento certo.
Skills, MCP, subagentes e hooks
Esses quatro se confundem muito; cada um resolve um problema diferente.
- Skill: conhecimento e scripts para um trabalho; o modelo decide quando usar.
- MCP: adiciona novas ferramentas e conexões com serviços externos.
- Subagente: um agente auxiliar que trabalha em um contexto separado.
- Hook: um comando que roda em um determinado evento toda vez, independentemente do modelo.
Escrevendo uma boa skill
Uma skill só é útil se for acionada na hora certa e continuar curta.
- Em description, diga com clareza o que a skill faz e quando usá-la.
- Mantenha o SKILL.md curto e mova referências longas para arquivos separados.
- Transforme passos repetidos e exatos em scripts para o modelo não reescrevê-los toda vez.
- Leia as skills de outras pessoas antes de instalá-las; os scripts delas rodam na sua máquina.
Skills no AgentVera
A galeria de skills do AgentVera reúne em uma lista as skills do Claude Code e do Codex que estão no seu computador, e os perfis de contexto permitem controlar o quanto as skills somam à primeira requisição.
- Details → Automation → Skills: crie, ative, desative, edite ou copie skills do Claude Code e do Codex para outro agente.
- Skills instaladas pela galeria têm os arquivos conferidos com SHA-256 e são analisadas no seu computador antes da instalação; os scripts nunca ficam executáveis.
- Compartilhar suas próprias skills com sua organização ou na galeria pública faz parte dos planos Pro e Team; skills públicas passam por aprovação de um moderador.
- O perfil de contexto Lean desliga plugins, hooks, skills e MCP externos do usuário, reduzindo a primeira requisição do Claude Code de cerca de 34,4 mil para 13,3 mil tokens.
Perguntas frequentes
Qual a diferença entre uma skill e MCP?
O MCP dá a um agente novas ferramentas e conexões; uma skill ensina como fazer um trabalho. Uma skill pode até descrever como usar ferramentas MCP no caminho.
Skills gastam tokens em toda requisição?
Só os nomes e as descrições ficam no contexto em toda requisição. O conteúdo completo carrega quando o modelo decide usar a skill.
Como faço o agente usar uma skill?
Normalmente você não precisa fazer nada; o modelo carrega uma skill quando a tarefa combina com a descrição dela. Você também pode citar a skill pelo nome na sua mensagem e pedir que o agente a use.
É seguro instalar a skill de outra pessoa?
Depende do que tem dentro. Skills contêm instruções e scripts, e os scripts rodam no seu computador. Leia o SKILL.md e os scripts antes de instalar.