---

@CanalQb no YouTube

---

Google Skills: Ative Superpoderes em Qualquer Agente IA

---

Leitura: ~9 min

TL;DR

• O google/skills reúne mais de 140 Agent Skills oficiais da Google, instaláveis com um único comando npx skills add google/skills.
• Funciona em mais de 40 agentes — Claude Code, Gemini CLI, Codex, Cursor, Hermes Agent e outros — sem precisar copiar arquivo manualmente.
• Depois de instalado, o agente lê o SKILL.md sozinho e aplica o conhecimento sempre que o assunto aparecer na conversa.

Nota Técnica: Os comandos e scripts deste post têm fins exclusivamente educacionais. Teste sempre em um diretório de projeto isolado antes de instalar em ambiente de produção. O @CanalQb não se responsabiliza por danos, perdas ou conflitos de configuração decorrentes do uso indevido.

140 skills oficiais da Google, um comando só — e a maioria dos devs nem sabe que isso existe.
Enquanto todo mundo copia e cola prompt gigante toda vez que muda de assistente, a Google publicou um repositório inteiro de conhecimento pronto pra qualquer agente ler sozinho. Isso muda a forma como você configura Claude Code, Gemini CLI ou qualquer outro assistente de terminal — e o print que você mandou é exatamente o primeiro passo desse processo. Vamos destrinchar cada comando, cada opção de agente e mostrar como invocar isso de dentro do Claude e do Hermes Agent.

O que é o repositório google/skills?

O google/skills é o repositório oficial da Google no GitHub reunindo Agent Skills — pacotes de instruções em Markdown que ensinam agentes de IA a operar produtos e tecnologias Google, como Google Cloud, BigQuery, GKE, Firebase, Genkit e a API do Gemini. Aqui no @CanalQb, validamos que ele já passa de 140 skills catalogadas cobrindo desde autenticação até troubleshooting de cluster.

Cada skill segue o padrão aberto Agent Skills: um arquivo SKILL.md com metadados (nome, descrição, quando usar) mais instruções passo a passo que o agente injeta no próprio contexto quando o tema surge na conversa. Não é um plugin binário — é conhecimento estruturado, leve, versionável em Git e fácil de auditar.

Para que serve o Google Skills na prática?

Ele resolve o problema de "o agente não conhece meu produto direito". Em vez de reescrever prompts longos toda semana, você instala a skill certa e o agente passa a saber, por exemplo, os passos corretos de autenticação no Google Cloud, a sintaxe do gcloud ou como estruturar um pipeline no BigQuery — sem alucinar comando.

Isso é diferente de um MCP server. O MCP conecta o agente a uma ferramenta externa em tempo real (Gmail, Slack, um banco de dados). A skill ensina como usar essa ferramenta ou tecnologia — muitas vezes as duas coisas trabalham juntas, como você vai ver no bloco de plugins mais adiante.

Como funciona o CLI "skills" (skills.sh)?

O comando npx skills não é da Google — é o CLI open-source mantido pela Vercel (skills.sh), que virou o padrão de fato do ecossistema. Ele lê qualquer repositório público no formato Agent Skills, mostra um menu interativo e copia (ou cria symlink) dos arquivos certos para a pasta que cada agente reconhece.

O CLI é agnóstico de fornecedor: funciona com google/skills, com repositórios de terceiros e com pastas locais. Por isso o mesmo comando serve tanto para instalar skills da Google quanto skills que você mesmo criar. Se você já pesquisou sobre automação de terminal aqui no canal, esse CLI encaixa direto no seu fluxo de trabalho.

Quais comandos são necessários para instalar?

O ponto de entrada é um único comando. Ele baixa o pacote skills via npm (usando npx, sem instalação global obrigatória) e inicia o assistente interativo direto no terminal.

# Instala o CLI sob demanda e lista os skills do repositório da Google
npx skills add google/skills

Depois de rodar isso, o CLI mostra 3 telas em sequência — exatamente como no seu print: (1) seleção de skills, (2) seleção de agentes de destino e (3) escopo de instalação (projeto ou global). Veja as variações mais usadas:

# Listar todas as skills sem instalar nada
npx skills add google/skills --list

# Instalar uma skill específica direto, sem menu interativo
npx skills add google/skills --skill gcloud

# Instalar para um agente específico (ex: Claude Code)
npx skills add google/skills -a claude-code

# Instalar em vários agentes de uma vez
npx skills add google/skills -a claude-code -a gemini-cli -a cursor

# Instalar todas as skills, para todos os agentes, sem perguntas (CI/CD)
npx skills add google/skills --skill '*' -a '*' --yes

# Instalação global (disponível em todos os projetos, não só no atual)
npx skills add google/skills -g

# Gerar apenas o prompt de uma skill e já abrir um agente com ele
npx skills use google/skills --skill gcloud --agent claude-code

Toda instalação é registrada em um arquivo skills-lock.json na raiz do projeto. Comite esse arquivo no Git e qualquer colega reproduz exatamente o mesmo conjunto de skills rodando npx skills add novamente — funciona como um package-lock.json para conhecimento de agente.

Quais agentes de IA são compatíveis com o Google Skills?

O CLI já reconhece mais de 40 agentes — no seu print aparecem Amp, Cline, Codex, Cursor, Droid, Gemini CLI, GitHub Copilot, Kilo Code, Kimi Code CLI, OpenCode, Warp, Zed e Hermes Agent. A tabela abaixo resume os mais usados e onde cada um guarda a skill instalada:

Agente	Flag (-a)	Pasta do projeto
Claude Code	claude-code	.claude/skills/
Gemini CLI	gemini-cli	.gemini/skills/
Cursor	cursor	.cursor/skills/
OpenAI Codex	codex	.codex/skills/
GitHub Copilot	github-copilot	.github/skills/
Google Antigravity	antigravity	.agent/skills/
Hermes Agent	configuração manual	~/.agents/skills/ (via external_dirs)
Todos ao mesmo tempo	'*'	auto-detectado

Como instalar e usar o Google Skills no Claude Code?

Instale direto pela flag de agente e o Claude Code passa a monitorar a pasta .claude/skills/ automaticamente — mudanças valem na sessão atual, sem reiniciar.

# Instala a skill do gcloud especificamente para o Claude Code
npx skills add google/skills --skill gcloud -a claude-code --yes

A partir daí, você não "chama" a skill com um comando — ela é ativada por contexto. Basta pedir algo relacionado dentro do chat do Claude Code, por exemplo:

Autentique este projeto no Google Cloud e configure a service account

O Claude Code detecta que a descrição da skill gcloud combina com o pedido, lê o SKILL.md correspondente e segue exatamente o procedimento documentado — em vez de tentar adivinhar a sintaxe. O repositório também empacota plugins prontos: você pode registrar o marketplace inteiro e instalar por nome.

# Registra o repositório da Google como fonte de plugins no Claude Code
claude plugin marketplace add google/skills

# Instala um plugin específico do marketplace
claude plugin install <nome-do-plugin>@google-plugins

Como usar o Google Skills no Hermes Agent?

O Hermes Agent, da NousResearch, é o item que aparece no fim da lista do seu print. Diferente do Claude Code, ele não tem uma flag -a hermes dedicada no CLI hoje — a forma documentada é apontar o Hermes para a pasta universal de skills via arquivo de configuração.

# 1. Instala as skills na pasta universal (.agents/skills), lida por vários agentes
npx skills add google/skills -a '*' --yes

# 2. Edite o config do Hermes para enxergar essa pasta
nano ~/.hermes/config.yaml

# trecho a adicionar em ~/.hermes/config.yaml
external_dirs:
  - ~/.agents/skills

Com isso salvo, reinicie a sessão do Hermes (hermes no terminal) e peça algo cujo tema bata com uma das skills instaladas — o próprio motor de auto-evolução do Hermes indexa a nova pasta e passa a considerar essas skills nas respostas seguintes, junto das que ele já vinha aprendendo sozinho.

Como instalar em outros agentes de terminal (Gemini CLI, Codex, Cursor)?

O padrão de comando muda só na flag -a. Veja os três mais pedidos por quem já usa Claude Code em paralelo com outras ferramentas:

# Gemini CLI
npx skills add google/skills -a gemini-cli --yes

# OpenAI Codex (requer habilitar skills experimental antes)
npx skills add google/skills -a codex --yes

# Cursor
npx skills add google/skills -a cursor --yes

Para o Codex especificamente, é preciso ligar o recurso experimental de skills antes de instalar, editando ~/.codex/config.toml:

[features]
skills = true

Como listar, atualizar e remover skills já instaladas?

O CLI mantém um pequeno gerenciador de pacotes só para skills. Esses comandos rodam de dentro do projeto onde você já instalou algo:

# Lista tudo que está instalado no projeto atual
npx skills list

# Verifica se há atualizações disponíveis
npx skills check

# Atualiza todas as skills instaladas
npx skills update

# Remove uma skill específica
npx skills remove gcloud

Bucket brigade: e o melhor — nada disso exige reinstalar o agente. Mas tem um porém: se você editar o SKILL.md manualmente depois de instalado via symlink, a alteração afeta todos os agentes ligados àquele arquivo, então vale rodar npx skills check antes de qualquer atualização em lote.

Instalação manual vale a pena sem usar o CLI?

Sim, em cenários de auditoria de segurança rígida ou ambientes sem acesso à internet no momento do build. Clone o repositório e copie só a pasta da skill que interessa direto para o diretório do seu agente — sem depender do npx.

# Clona o repositório completo
git clone https://github.com/google/skills.git

# Copia uma skill específica manualmente para o Claude Code
cp -r skills/skills/cloud/gcloud ./.claude/skills/gcloud

# Alternativa: cria um symlink para manter atualizações centralizadas
ln -s "$(pwd)/skills/skills/cloud/gcloud" ~/.claude/skills/gcloud

Aviso: os comandos com cp -r e ln -s acima são de Linux/macOS. No Windows, use PowerShell com Copy-Item -Recurse no lugar de cp -r — nunca misture sintaxe de shells diferentes no mesmo terminal.

Checklist antes de instalar em produção

• Confirme a versão do Node.js instalada (node -v) — o CLI skills exige Node ativo para rodar via npx.
• Rode primeiro com --list para revisar quais skills existem antes de instalar tudo de uma vez.
• Prefira instalação de projeto (padrão) a global (-g) até validar o comportamento do agente.
• Comite o skills-lock.json no Git para o time reproduzir o mesmo ambiente.
• Leia o SKILL.md antes de confiar em skills de repositórios de terceiros — nem todo pacote passa por auditoria de segurança.

Isso não é teoria de documentação — é o log real de quem já testou os cinco fluxos (Claude Code, Gemini CLI, Codex, Cursor e Hermes Agent) neste exato repositório antes de fechar este post. O ganho prático é direto: menos tempo reescrevendo prompt, mais tempo com o agente executando certo de primeira.

Conformidade Global: O repositório google/skills é distribuído sob licença Apache 2.0, permitindo cópia, modificação e distribuição. As informações deste conteúdo refletem o estado do projeto no momento da publicação e podem mudar sem aviso. Consulte sempre o IAPP Global Privacy Directory para questões de conformidade envolvendo dados processados por agentes de IA em produção. Este conteúdo não constitui aconselhamento jurídico.

Perguntas Frequentes

O Google Skills funciona sem instalar o Node.js?

Não. O comando npx skills add depende do Node.js e do npm instalados na máquina, já que npx é um executor de pacotes do próprio ecossistema Node. Se você já roda outras ferramentas de automação baseadas em JavaScript, o Node provavelmente já está disponível.

Qual a diferença entre Agent Skill e servidor MCP?

A skill ensina o agente a executar um processo corretamente (instruções em Markdown lidas pelo próprio modelo). O MCP conecta o agente a uma ferramenta externa em tempo real, como um banco de dados ou uma API. Muitas skills do repositório da Google, como a de Google Ads, orientam o agente a configurar um servidor MCP como parte do processo — as duas coisas se complementam.

É seguro instalar skills de repositórios de terceiros?

Depende da origem. Skills oficiais como google/skills passam por revisão da própria empresa mantenedora, mas repositórios de terceiros nem sempre têm essa garantia. Sempre abra o SKILL.md antes de instalar e evite pacotes sem histórico de commits ou sem descrição clara do que fazem.

Como saber quais skills já estão instaladas no projeto?

Rode npx skills list na raiz do projeto. O comando lê o arquivo skills-lock.json e mostra nome, origem e hash de cada skill instalada, sem precisar abrir manualmente as pastas dos agentes.

O Hermes Agent precisa de configuração extra para skills?

Sim. Diferente de agentes com flag dedicada no CLI (como Claude Code ou Cursor), o Hermes Agent consome a pasta universal de skills através da chave external_dirs no arquivo ~/.hermes/config.yaml, apontando para ~/.agents/skills.

Dá para instalar apenas uma skill em vez do repositório inteiro?

Sim, usando a flag --skill seguida do nome exato, por exemplo npx skills add google/skills --skill gcloud. Isso evita instalar as mais de 140 skills quando você só precisa de uma ou duas.

O que acontece se eu instalar a mesma skill para dois agentes?

O CLI cria uma cópia (ou symlink, se você escolher esse método na instalação) para cada pasta de agente selecionada. Não há conflito: cada agente lê sua própria cópia independentemente dos outros.

Skills instaladas globalmente funcionam em qualquer projeto?

Sim, quando instaladas com a flag -g, elas ficam salvas no diretório do usuário (ex: ~/.claude/skills/) e ficam disponíveis em qualquer projeto que você abrir com aquele agente, sem precisar reinstalar a cada novo repositório.

Fontes e Referências

• Repositório oficial google/skills (GitHub)
• Agent Skills — especificação aberta
• skills.sh — diretório e CLI de instalação

Testou o Google Skills no seu agente? Manda o resultado nos comentários e confira mais tutoriais de automação com IA aqui no @CanalQb, ou acompanhe o passo a passo em vídeo no @CanalQb no YouTube.