O que são as Skills do Antigravity?
As Skills do Antigravity agrupam instruções repetíveis para o trabalho com agentes. Em vez de colar as mesmas notas de configuração em todo prompt, você mantém um fluxo focado em uma skill nomeada e permite que o agente a descubra quando a descrição combina com a tarefa. Uma boa skill não é um livro de regras enorme: é uma unidade pequena e testável que explica quando se aplica, o que deve ler, quais etapas seguir e como reconhecer um resultado concluído.
A distinção mais importante é entre capacidade e permissão. Uma skill pode ensinar um agente a auditar um sitemap, revisar uma release ou preparar um componente. Ela não torna automaticamente todo comando seguro. Shell, rede, segredos, exclusão de arquivos, instalação de pacotes e ferramentas MCP ainda podem exigir aprovação. Mantenha os limites explícitos para ganhar consistência sem transformar um atalho em automação silenciosa.
A procura por Skills do Antigravity também inclui coleções no GitHub, dúvidas de instalação e comparações com Rules. São intenções próximas, mas não iguais. Esta página conduz da pasta vazia até uma skill verificada e encaminha perguntas sobre plugins, CLI, MCP e permissões para os guias adequados.
Onde ficam as Skills do Antigravity?
O local exato depende de você querer a skill disponível em um único projeto ou na sua conta de usuário. Siga a documentação oficial atual para a superfície que está usando e confirme o workspace e a conta ativos antes de investigar a descoberta. Um erro comum é criar um SKILL.md válido em um diretório que a sessão atual do agente nunca verifica.
Prefira o escopo do projeto quando a skill depende de scripts, convenções locais ou de um processo de deploy específico. Use o escopo do usuário para um fluxo geral testado em vários repositórios. Não coloque caminhos específicos do projeto nem segredos em uma skill global e não copie uma skill da comunidade para um repositório sensível antes de ler todos os arquivos referenciados.
| Escopo | Local típico | Melhor para | Primeira verificação |
|---|---|---|---|
| Projeto | .agents/skills/<skill-name>/ | Fluxos, scripts e convenções específicos do repositório | Abra o mesmo workspace que possui a skill e confira a branch ativa. |
| Usuário | Seu diretório de skills do usuário configurado | Fluxos reutilizáveis em projetos pessoais | Confirme o perfil conectado e o caminho de usuário documentado para a release atual. |
| Arquivos de referência | references/, scripts/, assets/ dentro da skill | Checklists longos, scripts auxiliares, exemplos e materiais de apoio | Leia as instruções da skill antes de executar qualquer helper. |
| Coleção externa | Um repositório Git revisado ou catálogo oficial | Descobrir fluxos da comunidade sem tratá-los como nativos | Confira autor, licença, commits, dependências e permissões solicitadas. |
Como criar uma Skill do Antigravity com SKILL.md
Comece pela menor skill útil. Escolha um trabalho, como conferir uma release de site estático, revisar uma migração ou preparar um plano de testes. Dê à pasta um nome estável em minúsculas e escreva uma descrição curta que diga o que a skill faz e quando deve ser selecionada. Uma descrição vaga pode impedir a descoberta; um escopo amplo pode fazer a skill ser escolhida para tarefas que ela não consegue concluir com segurança.
Mantenha o arquivo principal legível. Coloque no SKILL.md o fluxo, as restrições, as evidências esperadas e as condições de parada. Mova exemplos longos ou referências específicas para arquivos filhos e diga quando devem ser lidos. Quando uma skill pedir um comando, informe o comando, a saída esperada e o que fazer quando o resultado for diferente.
- Escolha uma tarefaDescreva a decisão do usuário que a skill ajuda a tomar, não todos os seus recursos e ferramentas.
- Crie a pastaUse um nome estável e o escopo de projeto ou usuário que você pretende testar.
- Escreva o frontmatterInclua um nome e uma descrição claros para que a descoberta combine naturalmente com a tarefa.
- Adicione o fluxoListe entradas, etapas ordenadas, evidências, limites de segurança e a definição de concluído.
- Teste com uma tarefa pequenaPeça primeiro uma simulação ou verificação somente leitura e só depois permita escritas.
name: sitemap-release-check; description: conferir um sitemap, inspecionar o HTML, validar com UTF-8 e relatar evidências antes de alterar arquivos.O exemplo ilustra uma estrutura; não promete o mesmo nome de pasta ou comando para toda release. Ajuste-o à documentação atual do Google e às convenções do seu repositório antes de publicar.
Como o agente usa uma skill
A descoberta normalmente começa pelo nome e pela descrição da skill. Quando uma tarefa parece combinar, o agente deve ler as instruções principais e carregar apenas as referências necessárias. Esse padrão de divulgação progressiva mantém o primeiro contexto pequeno e mostra quais detalhes influenciaram a resposta. Também cria um ponto natural de revisão: leia o arquivo da skill antes de confiar no fluxo proposto.
Uma skill útil descreve seus próprios limites. Diga se ela é somente leitura, quais diretórios estão no escopo, quais comandos são seguros, o que exige confirmação e quais evidências devem ser salvas. Se a tarefa alterar um repositório, exija a revisão final do diff e do status limpo. Se tocar em serviços externos, nomeie o endpoint ou a fonte oficial e não substitua silenciosamente por um espelho.
A primeira execução deve ser previsível. Peça um inventário de arquivos, uma explicação do plano ou a validação de um fixture inofensivo. Um comando inesperado, uma requisição de rede sem explicação ou um pedido de token são sinais para parar, não um convite para ampliar permissões.
Combinar
As palavras da tarefa e a descrição apontam para o mesmo fluxo reconhecível.
Ler
O agente carrega as instruções principais e apenas as referências relevantes para a tarefa.
Planejar
A skill expõe suposições, escopo de escrita, comandos e condições de parada antes da ação.
Verificar
O resultado contém arquivos, URLs, saídas de teste ou outras evidências concretas, não uma promessa vaga.
Revisar
Você confere o diff, as permissões e os efeitos externos antes de tornar o fluxo rotineiro.
Skills, Rules, plugins e MCP: qual é a diferença?
A expressão “personalização do Antigravity” cobre várias superfícies. Use uma skill para um procedimento repetível, uma Rule para uma instrução persistente que deve influenciar muitas tarefas, um plugin ou extension para integração e capacidades do produto, e MCP para uma conexão de ferramenta ou dados. Eles podem trabalhar juntos, mas não são sinônimos.
Regras do Antigravity é uma boa candidata para pesquisa própria no futuro, enquanto antigravity plugins já corresponde ao guia de Extensions do site. Aqui, mantenha a comparação prática: decida o que pertence ao arquivo da skill, enlace o guia existente adequado e evite duplicar um tutorial completo de MCP ou CLI.
| Superfície | Função principal | Use quando |
|---|---|---|
| Skill | Ensinar um fluxo repetível com entradas, etapas, referências e verificação | A tarefa tem início, fim e trilha de evidências reconhecíveis. |
| Rule | Manter uma preferência, restrição ou instrução de projeto persistente no escopo | A instrução deve influenciar muitas tarefas diferentes. |
| Plugin ou extension | Adicionar integração com o host, comando, recurso de linguagem ou capacidade de UI | Você precisa de integração do produto, e não de um procedimento escrito. |
| Servidor MCP | Expor ferramentas ou recursos de um serviço local ou remoto | O fluxo precisa de uma fronteira controlada de dados ou ações fora do texto da skill. |
Instale e verifique uma skill da comunidade com segurança
Uma coleção do GitHub pode ajudar, mas um resultado de pesquisa não é prova de confiança. Antes de copiar uma skill, confira o histórico do repositório, a licença, os scripts referenciados, os arquivos de pacote, as chamadas de rede e as credenciais necessárias. Leia o SKILL.md completo e todos os arquivos de referência ou scripts relacionados. Uma skill curta ainda pode pedir um comando destrutivo se seus detalhes não forem examinados.
Depois da instalação, verifique a descoberta no menor workspace que reproduza a tarefa. Comece com uma solicitação somente leitura e peça ao agente que explique qual skill escolheu e por quê. Compare os arquivos esperados com o diff real. Se a skill depender de uma CLI, plugin ou servidor MCP, teste essa dependência separadamente para não confundir uma falha de dependência com um problema de descoberta.
- Leia a origemConfira autor, licença, histórico, referências, scripts, dependências e endpoints externos.
- Copie para um escopo de testeUse um repositório descartável ou uma pasta de projeto antes de tornar a skill global.
- Execute um prompt somente leituraPeça inventário, explicação ou simulação antes de permitir edições ou comandos de shell.
- Inspecione as evidênciasConfirme que a skill selecionada, os arquivos lidos, os comandos sugeridos e a saída correspondem à sua intenção.
- Amplie com cuidadoCompartilhe a skill mais amplamente somente quando o fluxo estiver previsível e as permissões documentadas.
- Não coloque chaves de API, dados de sessão do navegador ou credenciais de produção em um arquivo de skill.
- Mantenha ações de exclusão, deploy, pagamento, mensagens e administração de contas sob revisão manual.
- Fixe ou revise dependências quando a skill chamar um script, gerenciador de pacotes ou serviço externo.
- Use controle de versão para que uma alteração gerada possa ser inspecionada e revertida.
- Trate uma requisição de rede desconhecida como motivo para parar e investigar.
Verificação de versão e fonte oficial
Este projeto é um site de download de software, portanto a verificação de atualização foi concluída antes da publicação do guia. Em 19 de agosto de 2026, a documentação oficial do Antigravity e o fluxo de download foram conferidos para as linhas atuais. O site registra Antigravity 2.0 v2.8.1 e Antigravity IDE v2.5.5; o guia da CLI foi sincronizado para v1.1.14. O comportamento das Skills pode mudar separadamente das versões dos instaladores, então use a documentação oficial de Skills como autoridade final.
A chamada para download continua sendo um fallback para a página oficial. Não inventamos URL permanente de binário, tamanho de pacote, checksum ou resultado de análise de segurança. As páginas históricas v1.13.3 e v2.2.1 permanecem como arquivos e não são apresentadas como a versão atual.
Perguntas frequentes sobre Skills do Antigravity
O que é uma Skill do Antigravity?
É um conjunto reutilizável de instruções, geralmente organizado em torno de um arquivo SKILL.md, que ajuda um agente a executar um fluxo especializado de forma consistente. Ela ensina o procedimento, mas não concede automaticamente permissão para executar qualquer comando.
Como adicionar Skills ao Antigravity?
Crie ou copie uma pasta nomeada de skill para o escopo de projeto ou usuário documentado pela versão atual do Antigravity. Confirme que há um SKILL.md legível e teste a descoberta em um workspace pequeno com uma solicitação somente leitura antes de permitir edições.
Como criar um SKILL.md?
Escolha uma tarefa específica, crie uma pasta estável, adicione nome e descrição no frontmatter e documente entradas, etapas, referências, limites de segurança e o que significa concluir. Mova material longo para references ou scripts e diga quando ele deve ser lido.
Posso usar Claude Skills no Antigravity?
Não presuma compatibilidade imediata. Revise a estrutura da pasta, o frontmatter, os comandos, os caminhos e as suposições de permissão; adapte a skill ao Antigravity e teste-a antes de tratá-la como um fluxo nativo.
Qual é a diferença entre Skills e Rules do Antigravity?
Uma skill normalmente é um procedimento para uma tarefa reconhecível. Uma Rule é uma instrução ou restrição persistente que deve influenciar muitas tarefas. Para uma checklist repetível, comece por uma skill; para uma preferência permanente, pesquise o formato atual de Rules.
As Skills do Antigravity são seguras?
Um arquivo de skill não é automaticamente seguro nem oficial. Leia a origem e cada script referenciado, teste em um projeto descartável ou de baixo risco, mantenha segredos fora do arquivo e exija revisão para ações destrutivas, de rede, credenciais, deploy ou conta.
Onde encontrar Skills do Antigravity no GitHub?
Procure um repositório ou coleção cujo autor, licença, histórico, arquivos, dependências e permissões solicitadas possam ser examinados. Trate o GitHub como fonte de descoberta, não como prova de manutenção ou segurança.
Skills substituem plugins, comandos da CLI ou servidores MCP?
Não. Skills descrevem fluxos, plugins e extensions acrescentam integrações com o host, comandos de CLI realizam operações no terminal e servidores MCP expõem ferramentas ou recursos. Conecte essas superfícies apenas quando a tarefa realmente precisar delas.
Fontes oficiais
- Documentação Google Antigravity Skills — Conceitos, estrutura, descoberta e uso oficial das Skills.
- Documentação Google Antigravity IDE Skills — Comportamento das Skills específico do IDE e terminologia atual do produto.
- Documentação Google Antigravity Rules — Fonte para Rules persistentes, não para Skills de tarefas.
- Plugins e Skills da Google Antigravity CLI — Limite específico da CLI entre plugins e Skills.
- Download do Google Antigravity — Seleção oficial de plataforma e instalador para conferir pacotes atuais.