# O que são Agent Skills?

URL: https://agentvera.dev/pt/glossary/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.

- **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.

---

**Sobre o AgentVera.** AgentVera é um app desktop para macOS, Windows e Linux, desenvolvido pela Solviera Teknoloji. Ele roda 18 agentes de programação com IA (Claude Code, Codex, Gemini CLI, Copilot, Cursor, Antigravity, opencode, Hermes, Qwen Code, Kimi Code, Kiro, Amp, Droid, Goose, Vibe, Crush, Aider, Cline) lado a lado, por projeto, em terminais reais com as instalações e logins de CLI do próprio usuário. O plano gratuito tem agentes ilimitados. Baixar: https://agentvera.dev/pt/download/ · Preços: https://agentvera.dev/pt/pricing/