Agent Skills: Acelerando o Gemini CLI com Expertise Sob Demanda

Já pensou em dar um upgrade no seu Gemini CLI, adicionando superpoderes específicos para cada tarefa? É exatamente isso que as Agent Skills fazem! Elas funcionam como módulos de conhecimento especializado, trazendo workflows práticos e recursos focados para que o Gemini resolva seus pepinos com maestria. Baseadas no padrão aberto [Agent Skills](https://agentskills.io), cada “skill” é um pacote compacto de instruções e arquivos que se torna uma capacidade nova e descoberto pelo agente.

O Que São Agent Skills e Por Que Elas São Geniais?

Diferente dos arquivos de contexto geral, que servem como um background fixo para o seu workspace, as Skills são puro conhecimento sob demanda. Imagine ter um exército de especialistas prontos para entrar em ação: um para auditar a segurança, outro para fazer deploy na nuvem, e mais um para migrar seu código. Com as Skills, o Gemini mantém uma biblioteca gigante dessas expertises sem sobrecarregar a memória (context window) com informações desnecessárias. Ele é esperto e decide na hora qual skill usar, baseado no que você pediu e na descrição da skill. Ao identificar uma match, ele ativa a skill com a ferramenta `activate_skill`, trazendo tudo que precisa para a missão.

Benefícios Que Vão Mudar Seu Jogo

• Compartilhe Sabedoria: Empacote processos complexos, como o jeito que seu time faz code review, em uma pasta que qualquer um pode usar.
• Workflows Repetíveis: Garanta que tarefas de vários passos sejam executadas sempre da mesma forma, graças a um roteiro claro.
• Tudo no Pacote: Inclua scripts, templates ou exemplos de dados junto com as instruções. Assim, o agente tem o kit completo para trabalhar.
• Inteligência Progressiva: No começo, o Gemini só carrega o básico (nome e descrição da skill). As instruções detalhadas e os arquivos só aparecem quando o agente realmente precisa deles, economizando tokens preciosos.

Onde o Gemini Encontra Suas Skills?

O Gemini CLI é um detetive de skills e as encontra em três lugares principais:

1. Skills do Workspace: Arquivos em `.gemini/skills/` ou no atalho `.agents/skills/`. Geralmente, são compartilhadas com a equipe e versionadas.
2. Skills do Usuário: Ficam em `~/.gemini/skills/` ou `~/.agents/skills/`. São suas skills pessoais, disponíveis em qualquer projeto.
3. Skills de Extensão: Vêm junto com as extensões que você instala.

Hierarquia é importante: Se houver skills com o mesmo nome, as de locais mais altos na lista levam vantagem (Workspace > Usuário > Extensão). E dentro do mesmo nível (Usuário ou Workspace), o atalho `.agents/skills/` tem prioridade sobre `.gemini/skills/`.

Gerenciando Suas Skills

Na Conversa: Use o comando `/skills` para dar uma olhada e gerenciar:

• `/skills list` (padrão): Mostra todas as skills encontradas e se estão ativas.
• `/skills link `: Conecta suas skills de uma pasta local.
• `/skills disable `: Desativa uma skill específica.
• `/skills enable `: Reativa uma skill desativada.
• `/skills reload`: Atualiza a lista de skills de todos os lugares.

Lembre-se: `disable` e `enable` mexem nas suas skills pessoais por padrão. Use `–scope workspace` para gerenciar as do projeto.

No Terminal: O comando `gemini skills` é seu aliado:

# Ver todas as skills
gemini skills list

# Conectar skills de um repositório local (cria links simbólicos em ~/.gemini/skills)
gemini skills link /caminho/para/meu-repo-de-skills

# Conectar para o seu workspace
gemini skills link /caminho/para/meu-repo-de-skills --scope workspace

# Instalar uma skill (de Git, local ou .skill)
gemini skills install https://github.com/user/repo.git
gemini skills install /caminho/para/skill-local.skill

# Instalar de um subdiretório (ótimo para monorepos)
gemini skills install https://github.com/my-org/my-skills.git --path skills/frontend-design

# Instalar para o workspace
gemini skills install /caminho/para/skill --scope workspace

# Remover uma skill
gemini skills uninstall nome-da-skill --scope workspace

# Ativar uma skill (geralmente global)
gemini skills enable nome-da-skill

# Desativar uma skill (usa --scope para workspace ou user)
gemini skills disable nome-da-skill --scope workspace

Como A Mágica Acontece?

1. Descoberta: No início da sessão, o Gemini CLI escaneia todas as suas skills e joga nome e descrição no prompt do sistema.
2. Ativação: Quando o Gemini percebe que uma tarefa combina com uma skill, ele usa a ferramenta `activate_skill`.
3. Confirmação: Você verá um pop-up na interface, mostrando o nome da skill, o que ela faz e quais pastas ela poderá acessar.
4. Injeção: Com sua aprovação, o conteúdo do arquivo `SKILL.md` e a estrutura da pasta são adicionados ao histórico. A pasta da skill também é liberada para o agente ler seus arquivos.
5. Execução: O modelo entra em modo especialista, priorizando as instruções da skill para concluir a tarefa.

Uma vez ativada e aprovada, a skill fica carregada no contexto do agente. Ela mantém sua expertise ativa e suas instruções como prioridade durante toda a sessão.

Quer Criar Suas Próprias Skills?

Se você ficou animado para criar seus próprios superpoderes para o Gemini, confira o guia [Criando Agent Skills](/docs/cli/creating-skills) e comece a inovar!