Tutorial de Antigravity Skills: instale, crie e gerencie Agent Skills
O que são as skills do Antigravity, como instalar uma biblioteca com mais de 1.300 skills do GitHub em um comando, como escrever seu próprio SKILL.md e como encadear skills em workflows — cada passo verificado em gravações reais de tela.
Antigravity skills em 30 segundos
- Uma skill é uma pasta com um SKILL.md dentro de .agents/skills (workspace) ou do seu diretório global de skills. O agente primeiro lê apenas o nome e a descrição e carrega as instruções completas quando a tarefa precisa delas.
- O repositório open source antigravity-awesome-skills traz mais de 1.300 skills prontas. Um comando — npx antigravity-awesome-skills — as instala na sua pasta de skills.
- Crie sua própria skill adicionando uma pasta mais um SKILL.md com frontmatter de name e description; quando precisar de verificações determinísticas, coloque um script Python ou shell em uma subpasta scripts/.
- Bundles dizem quais skills combinam com o seu papel; workflows encadeiam skills em ordem — o workflow Ship a SaaS MVP vai do brainstorming à revisão de segurança.
Antigravity Skills Kit: Use 1,239+ Agent Skills in One Command
Canal:AI Stack Engineer9:13
How to Create Agent Skills in Google Antigravity (2026)
Canal:The Code City5:21
Intro to Agent Skills
Canal:Google Antigravity4:06
Cada passo abaixo foi verificado quadro a quadro contra essas gravações; o carimbo de tempo de cada captura aponta para o momento exato do vídeo. Os fatos sobre o frontmatter do SKILL.md e as pastas de skills foram cruzados com o vídeo oficial do Google, Intro to Agent Skills.
As capturas de tela vêm das gravações dos criadores citados; o texto do guia é nosso. Fontes: AI Stack Engineer (repositório e docs), The Code City (criação de skills no IDE).
Como instalar, criar e gerenciar skills do Antigravity
Entender o que são as skills do Antigravity
- 1
Saber o que é uma skill: um SKILL.md com nome e descrição
Uma skill é uma pasta que contém um arquivo SKILL.md. O frontmatter carrega um name e uma description, e o corpo traz instruções, boas práticas e scripts opcionais. Ao iniciar uma conversa, o Antigravity vê apenas o nome e a descrição de cada skill e lê o arquivo completo quando a tarefa corresponde — assim as skills agregam conhecimento especializado sem consumir contexto permanentemente.
A documentação oficial define as três partes de um pacote de skills.Ver em 1:15 - 2
Escolha onde as skills vivem: workspace ou global
O Antigravity suporta dois escopos. Skills de workspace vivem na pasta .agents/skills do seu projeto e servem para convenções de equipe, como processos de deploy ou regras de teste. Skills globais funcionam em todos os projetos e servem para utilitários pessoais. A documentação informa que o Antigravity agora usa .agents/skills por padrão e mantém .agent/skills por compatibilidade.
Dois escopos, uma convenção: escolha a pasta conforme o alcance desejado da skill.Ver em 1:18
Instalar uma biblioteca de skills do GitHub
- 3
Abra a biblioteca antigravity-awesome-skills no GitHub
A maior coleção da comunidade é o repositório antigravity-awesome-skills: mais de 1.300 skills prontas para planejamento, código, testes, segurança e produto, cobrindo Claude Code, Gemini CLI, Cursor, Copilot, Antigravity e outros agentes. Navegue pelo README e pelo catálogo antes de instalar qualquer coisa.
A página do repositório mostra o tamanho da coleção e a versão atual.Ver em 8:50 - 4
Instale a biblioteca com um comando npx
Execute npx antigravity-awesome-skills no terminal. O instalador coloca os arquivos SKILL.md na sua pasta de skills — o caminho global de skills do Antigravity por padrão. Flags direcionam outras ferramentas (--cursor, --claude, --codex, --gemini, --agents e mais), e --path aponta para um diretório personalizado. Use --help para listar todas as opções.
O instalador lista uma flag para cada agente e IDE compatível.Ver em 2:10 - 5
Escolha um bundle inicial em vez de rolar 1.300 skills
O bundles.md do repositório seleciona skills por papel. Web Wizard foca em padrões React, Tailwind e design front-end; Hacker Pack cobre metodologia de pentest e varredura de vulnerabilidades; Product Pack reúne brainstorming, planejamento e SEO; Essentials traz o básico de código limpo, planejamento e validação. Um bundle é uma lista de leitura que indica quais skills instaladas importam para o seu trabalho.
Quick Start: instale o repositório uma vez e siga o bundle do seu papel.Ver em 2:35 - 6
Confira as fontes oficiais e os níveis de confiança antes de executar
Nem toda skill tem o mesmo nível de confiança. Skills oficiais vêm direto de fornecedores como Anthropic, Google, OpenAI, Vercel e Supabase. Contribuições da comunidade são classificadas como safe (somente leitura ou planejamento) ou arriscadas (modificam sistemas ou executam testes de segurança). Tudo é MIT e legível: abra o SKILL.md e veja o que a skill faz antes de deixar o agente usá-la.
O README credita as coleções oficiais nas quais a biblioteca se apoia.Ver em 4:52
Criar sua própria skill no IDE
- 7
Crie a pasta .agents/skills no seu projeto
No Antigravity, clique com o botão direito na raiz do projeto no Explorer e escolha New Folder. Crie .agents, depois uma pasta skills e, dentro dela, uma pasta por skill — por exemplo code-reviewer, deployer ou sql-reviewer. As skills de workspace encontradas aqui ficam disponíveis para o agente neste projeto.
Botão direito → New Folder é tudo o que é preciso para começar a árvore de skills.Ver em 0:58 - 8
Siga a convenção oficial de dois passos
A documentação do Google mantém tudo simples: crie uma pasta para a sua skill dentro de um diretório de skills e adicione um arquivo SKILL.md dentro dela. O SKILL.md precisa de frontmatter YAML no topo — um name e uma description que digam para que a skill serve e quando usá-la — seguidos das instruções detalhadas para o agente.
Os docs mostram a árvore .agents/skills/my-skill/SKILL.md e o frontmatter necessário.Ver em 1:20 - 9
Escreva o nome e a descrição que o agente lê primeiro
O Antigravity primeiro lê apenas o frontmatter, então a description decide quando sua skill é carregada. Seja específico: name: code-review, description: Reviews code changes for bugs, style issues, and best practices. Use when reviewing PRs or checking code quality. Descrição vaga significa que a skill nunca dispara; descrição precisa dispara exatamente quando necessário.
Só essas primeiras linhas são analisadas no início da conversa — escreva-as para o roteador, não para o leitor.Ver em 1:36 - 10
Adicione as políticas que sua skill impõe
Abaixo do frontmatter, escreva as regras em markdown. Uma skill sql-reviewer pode impor: nada de DROP TABLE, nomes de tabelas em snake_case e uma coluna id como PRIMARY KEY em toda tabela. Estruture o corpo como Policies Enforced mais Instructions para que o agente conheça as regras e o procedimento — e só carregue esses detalhes quando aparecer uma tarefa de SQL.
Convenções de equipe viram regras aplicáveis quando passam a viver na skill.Ver em 2:55 - 11
Dê à skill um script para verificações determinísticas
Regras que um modelo pode deixar passar a olho nu são melhor aplicadas por código. Adicione uma pasta scripts/ ao lado do SKILL.md — aqui validate_schema.py verifica cada tabela em busca da chave primária id e de nomes em snake_case. O SKILL.md diz ao agente para executar o script com a ferramenta run_command em vez de ler arquivos manualmente e interpretar o exit code: 0 significa que o schema está bom, 1 significa reportar os erros impressos.
O script faz a varredura; o agente só o executa e repassa o veredito.Ver em 3:56 - 12
Rode a skill com um prompt real
Peça ao agente: validate @my_schema.sql. O Antigravity encontra a skill sql-reviewer pela descrição, lê o SKILL.md completo, executa validate_schema.py e repassa o resultado. No arquivo de teste ele reporta ERROR: Table 'users' is missing a primary key named 'id' e sugere o CREATE TABLE corrigido — exatamente a revisão para a qual a skill foi escrita.
O veredito da skill e a correção sugerida aparecem no chat.Ver em 4:34
Explorar, encadear e verificar
- 13
Explore o catálogo por categoria
A biblioteca agrupa suas mais de 1.300 skills em Architecture, Business, Data & AI, Development, General, Infrastructure, Security, Testing e Workflow, com um catalog.json para busca. Se nada combina com as convenções internas do seu time, use o @skillcreator — ele faz perguntas e gera um skill.md pronto para soltar na sua pasta de skills.
Nove categorias cobrem o catálogo; o skillcreator preenche as lacunas.Ver em 4:05 - 14
Encadeie skills com um workflow
Bundles dizem quais skills importam para um papel; workflows dizem em que ordem usá-las. O workflow Ship a SaaS MVP executa Find the scope (brainstorming, PRD writer), Build backend and API, Build frontend e segue — cada passo nomeia suas skills e um prompt de exemplo. Invoque pedindo ao agente para rodar o workflow com a sua ideia de projeto.
Um arquivo de workflow ordena as skills do plano ao produto entregue.Ver em 3:45 - 15
Verifique o resultado: três skills, um dashboard
Na demonstração do repositório, @brainstorming faz perguntas estruturadas — página isolada ou app, dados mockados ou reais, comportamento responsivo — antes de gerar um documento de planejamento. @frontend-design e @react-patterns então constroem uma sidebar, componentes de metric cards tipados, um line chart do recharts e um activity feed fiéis ao plano. Esse é o propósito das skills: um contrato contra o qual a saída pode ser conferida.
O dashboard de analytics pronto — saída estruturada em vez de um chute único.Ver em 6:30