Skills no Google Antigravity: como instalar na pasta .agents/skills e usar na prática

Por que o seu site sai com cara de robô quando você usa o Antigravity puro

Se você já abriu o agente do Google, pediu pra ele criar uma página de vendas pra uma clínica ou uma oficina mecânica e recebeu um site roxo genérico, com três caixinhas tortas e texto com cara de robô, a culpa não é da ferramenta. O problema é que você colocou um motor forte pra rodar no escuro. Quando alguém pesquisa por Antigravity skills no Google, o que essa pessoa está procurando de verdade é como dar repertório técnico, direção de arte e método comercial pro agente antes de ele encostar no código.

No guia completo do Google Antigravity, eu explico a visão geral da plataforma. Aqui nós vamos abrir o capô da pasta de habilidades. Uma skill nada mais é do que uma subpasta com um arquivo chamado SKILL.md (escrito assim mesmo, em letras maiúsculas) que ensina o agente a executar uma tarefa específica com padrão profissional: escolher tipografia que combina com o nicho, montar a estrutura de persuasão da página, comprimir imagens ou revisar se o formulário do WhatsApp está funcionando no celular.

Sem skills, você gasta vinte mensagens tentando explicar no gogó como quer o visual do site. Com a pasta certa no projeto, o Antigravity já lê as regras antes de escrever a primeira linha.

Onde ficam as skills no Google Antigravity: pasta do projeto vs pasta global

A primeira coisa que você precisa dominar é o endereço exato onde o programa procura esses manuais. Pela documentação oficial do Google, o caminho padrão é a pasta .agents/skills do projeto (a .agent/skills, o nome antigo, ainda funciona); as skills que valem pra todo projeto ficam em ~/.gemini/config/skills, no app e no IDE. Vamos separar os dois níveis pra você nunca salvar arquivo no lugar errado:

• Skills do projeto (`.agents/skills/`): ficam dentro da pasta do site ou sistema que você está construindo naquele momento. Se você ainda tiver projetos antigos usando .agent/skills/ (no singular), o Antigravity continua lendo normalmente por compatibilidade, mas o padrão atual adotado pelo mercado inteiro é .agents/skills/ no plural.
• Skills globais da sua máquina (`~/.gemini/config/skills/`): ficam salvas na pasta do seu usuário no computador e valem pra qualquer projeto que você abrir no aplicativo ou no editor completo do Antigravity.

Repare na beleza desse padrão: a pasta .agents/skills/ do projeto no Antigravity é exatamente a mesma que o agente da OpenAI usa (lá no guia de skills no Codex você vê que ele aponta pra a pasta .agents/skills do projeto (ou a ~/.agents/skills, pra valer em todo projeto)). E no Claude Code, basta manter a ponte com .claude/skills. Isso significa que você não fica refém de nenhuma empresa. Você monta ou instala a sua caixa de ferramentas uma única vez e troca de agente na hora que quiser.

Como o Antigravity lê uma skill sem estourar a sua cota semanal

Uma dúvida muito comum de quem começa a trabalhar com Antigravity skills é: Vagner, se eu colocar dezenas de skills dentro da pasta do meu projeto, o agente vai ler todas elas a cada pergunta minha e acabar com a minha cota em dez minutos? Não vai, e o motivo técnico pra isso é muito bem bolado.

O Antigravity usa um sistema de leitura sob demanda (que a documentação chama de descoberta progressiva). Funciona em três etapas simples:

1. 11. Leitura rápida do catálogo (só nome e descrição): ao abrir o projeto, o Antigravity lê apenas as primeiras linhas de cada arquivo SKILL.md (name e description), consumindo quase zero de memória.
2. 22. Ativação inteligente na hora da tarefa: quando você faz um pedido no chat, o agente cruza a tarefa com o catálogo curto e abre somente o arquivo SKILL.md daquela função.
3. 33. Consulta aos arquivos de apoio só quando precisa: se dentro da pasta daquela skill houver subpastas como references/ ou scripts/, o agente só abre esses arquivos extras no momento em que a etapa exigir.

Pra quem usa os planos e preços do Antigravity na faixa gratuita, onde a cota renova uma vez por semana e, a partir de 2 de novembro de 2026, fica concentrada no Gemini 3.8 Flash, essa leitura sob demanda vale ouro. O agente carrega apenas a instrução cirúrgica que precisa pra acertar de primeira.

Anatomia do arquivo SKILL.md: como escrever ou revisar uma skill

Dentro de .agents/skills/, cada habilidade mora na sua própria pasta com um arquivo SKILL.md. Se quiser aprender a desenhar seus próprios manuais, veja o guia de como criar uma skill do zero, mas confira abaixo a estrutura básica que o Antigravity reconhece:

No topo do SKILL.md, um bloco entre três tracinhos (---) traz o nome e a descrição que ensinam ao Antigravity quando acionar aquela habilidade. Abaixo vem o passo a passo técnico: o que fazer, o que evitar e como validar a entrega.

A diferença entre Skills, Rules (GEMINI.md) e roteiros de tarefas no Antigravity

O programa divide a personalização em três gavetas diferentes, e usar a gaveta certa deixa o agente muito mais obediente:

O erro clássico de quem tenta fazer tudo sozinho é jogar um texto gigante de cinco mil palavras dentro do GEMINI.md. Quando você faz isso, o agente carrega aquele caminhão de texto até pra trocar um telefone no rodapé. O jeito profissional é deixar o arquivo de regras fixas enxuto e colocar toda a inteligência pesada dividida em Antigravity skills dentro de .agents/skills/.

Funciona no App, no IDE, no CLI e na extensão do VS Code?

Sim. Como o Google oferece o Antigravity App (o aplicativo de computador, a central dos agentes), o Antigravity IDE (o editor completo, baixado à parte), o Antigravity CLI (o comando agy, no terminal) e as extensões pro VS Code, o Visual Studio, os editores da JetBrains, o Zed e o Xcode; e tem ainda o SDK em Python, pra quem programa o próprio agente, a leitura da pasta .agents/skills/ acontece em qualquer uma dessas pontas. Basta seguir o passo a passo de como baixar e instalar o Antigravity, abrir a pasta do projeto e conferir no guia geral de como instalar skills passo a passo se o arquivo SKILL.md está no lugar certo.

As melhores skills pro Antigravity

Como o Antigravity lê o mesmo SKILL.md do padrão aberto, a maioria das skills do Shopping de skills roda nele. Separei as que mais ajudam quem cria site pros clientes, e de cada uma digo por que ela roda no Antigravity:

• gemini-api-dev skill, do Google: escreve o código que chama a API do Gemini com os modelos e o SDK de agora, sem cair em modelo aposentado. As skills do Gemini já vêm no Antigravity, na engrenagem, em Customizations > Build with Google Plugins. O código que ela escreve pede uma chave da API do Gemini.
• design-md skill, do Google Labs: lê as telas que você desenhou no Stitch e escreve um DESIGN.md com as cores, as fontes e o estilo, pra próxima tela sair com a mesma cara. O repositório lista o Antigravity entre os agentes compatíveis, com o MCP do Stitch ligado.
• stitch-loop skill, do mesmo repositório: monta o site página por página no Stitch, encaixa cada uma com a navegação ligada e deixa escrito qual é a próxima.
• ui-ux-pro-max skill: um banco de paletas, pares de fontes e regras de UX que o agente consulta antes de desenhar, escolhendo pelo tipo do negócio. O instalador dela tem a opção do Antigravity.
• impeccable skill: põe o agente pra projetar, criticar e dar acabamento na tela, de landing page a painel. O repositório traz a versão pronta pro Antigravity, pra pasta do projeto ou pra global.
• frontend-design skill, da Anthropic: tira a página da cara de site feito por IA, escolhendo cor, fonte e layout pelo assunto do negócio. É só instrução, sem script, então o Antigravity segue igual ao Claude.
• brainstorming skill, do Superpowers: antes de construir, o agente entende o que você quer e mostra duas ou três formas de fazer. O Superpowers tem instalação própria pro Antigravity, como plugin, e o resto dele tá no guia do Superpowers.
• copywriting skill, do Corey Haines: escreve a copy da página seção por seção, com opções de título e de botão, e não deixa entrar promessa que você não prova. São instruções e arquivos de referência, que qualquer agente com skills lê.
• antigravity-design-expert skill: apesar do nome, não é do Google. Antigravidade aqui é um estilo visual, de cards que flutuam, vidro fosco e profundidade, com animação no GSAP. Ela vem do Agentic Awesome Skills, o antigo antigravity-awesome-skills, uma coleção da comunidade com mais de 2.750 skills que se diz independente do Google.

Pra instalar, a página de cada uma no shopping tem o comando. Quando ele é o npx skills add, que é o caso da maioria, acrescente -a antigravity no fim, que a skill vai pra pasta .agents/skills do projeto. Na Antigravity CLI, o que vem empacotado como plugin entra pelo agy plugin install.

Na prática: o choque de realidade quando você trabalha sem a pasta de skills

Depois que você acostuma a construir sites com uma biblioteca de skills bem amarrada, até esquece como o modelo puro é perdido. Só quando alguém abre um projeto vazio por engano é que a ficha cai.

Esse comentário resume a vida real. O aluno foi levantar um projeto novo, esqueceu de puxar a estrutura do MazyOS pra pasta e tomou um susto com o resultado cru que a IA entregou sozinha. Não importa o motor escolhido (mostramos essa disputa no comparativo entre Antigravity e Claude Code): sem direção técnica, o modelo sempre cai na média rasa da internet.

Por que instalar as skills do MazyOS em vez de tentar escrever tudo do zero

No MazyOS, todo esse repertório já está pronto, testado em campo e empacotado pra rodar em dois minutos. O sistema funciona roda no Claude Code, no Codex e no Antigravity, e na área de membros já existe o curso tem uma aula só do Antigravity pra você não travar em nada. Além das skills técnicas, você leva o método comercial pra prospectar clientes, apresentar a prévia pronta e cobrar bem por projeto. O acesso sai por R$ 97 por um ano ou R$ 197 pra sempre, no pagamento único, no Pix ou em até 12x, com a garantia tripla: 7 dias de arrependimento; a Garantia de Destrave Técnico, em que alguém da equipe instala o MazyOS junto com você numa chamada, se o primeiro site não sair; e a Garantia de Campo, de 60 dias: apresentou a prévia pronta pra 10 empresários, da sua agenda ou da sua cidade, e não fechou nenhum contrato, o dinheiro volta no Pix pra testar no seu computador.