Como criar Skills personalizados no Antigravity: guia completo com estrutura, escopos e exemplos

Como criar Skills personalizados no Antigravity: guia completo com estrutura, escopos e exemplos

Uma Skill no Antigravity é uma pasta com um arquivo SKILL.md obrigatório (e, se você quiser, subpastas opcionais como scripts, examples e resources). O SKILL.md começa com um bloco de frontmatter YAML com dois campos, name e description, seguido do corpo em markdown com as instruções que o agente deve seguir. Para criar uma Skill: monte essa pasta com o SKILL.md e salve no escopo desejado. Escopo workspace (do projeto) vai em .agents/skills/ na raiz do projeto e pode ser commitado pro time inteiro usar. Escopo global (pessoal) vai em ~/.gemini/antigravity/skills/ e vale em todos os seus projetos. Se houver Skill de mesmo nome nos dois, a do workspace prevalece. O Antigravity carrega a Skill sob demanda: no início lê só o frontmatter e puxa o corpo em markdown apenas quando a tarefa é relevante, decidindo pelo description.

Neste artigo, você vai descobrir tudo o que precisa saber sobre como criar Skills personalizados no Antigravity, desde o conceito dessas Skills até exemplos práticos de uso. O Antigravity está cada vez mais popular entre entusiastas de automações e agentes de IA, especialmente por permitir ampliar as funcionalidades dos agentes através de Skills que você mesmo pode criar. Vamos abordar toda a estrutura necessária, as diferenças entre escopo global e workspace e também apresentar exemplos para você já sair do papel para a prática. Se você busca automatizar tarefas, personalizar comportamentos e extrair o máximo potencial dos agentes no Antigravity, este guia é perfeito para começar!

Palavra-chave principal: como criar Skills personalizados no Antigravity
Palavras-chave secundárias: estrutura de um Skill no Antigravity, skills globais vs workspace no Antigravity, exemplos de Skills para Antigravity

O que são Skills personalizados no Antigravity?

Skills personalizados no Antigravity são funções adicionais que você pode desenvolver para os agentes dentro da plataforma. Em vez de depender apenas das capacidades originais do sistema, as Skills permitem a criação de comandos, integrações ou fluxos de trabalho sob medida para suas necessidades. Imagine que você quer que seu agente de IA possa buscar dados de uma planilha, gerar relatórios automáticos ou até mesmo interagir com APIs externas — é para isso que as Skills servem!

Essas Skills são codificadas e descritas em um arquivo chamado SKILL.md, o que torna o processo organizado e padronizado. O destaque é justamente o poder de personalização: qualquer um que compreenda o básico da estrutura pode desenvolver sua própria Skill e, assim, criar agentes mais inteligentes e automatizados.

É como adicionar “superpoderes” ao seu agente: você define o que ele vai saber fazer. Isso transforma a experiência com o Antigravity, tornando a plataforma não só mais avançada mas perfeitamente adaptável ao seu fluxo de trabalho, seja você um usuário iniciante ou mais avançado.

Lembre-se: criar Skills personalizados é um caminho eficiente para potencializar o valor de cada agente criado, ampliando automatizações e tornando o Antigravity uma ferramenta ainda mais estratégica para resolver problemas do dia a dia.

Formação Recomendada

Formação Vibe Coding

Do Prompt ao Produto: Crie Software Real com IA

• 474 aulas
• 20 projetos
• 39h 27min

Conhecer formação

Quer ir além? Dica de ouro para aprender agentes de IA e automações

Se você se interessou por como criar Skills personalizados no Antigravity, vale muito conferir a Formação Agentes de IA da Hora de Codar. Não é só um curso – são mais de 20 horas de aulas, repletos de exemplos práticos para construir, automatizar e até vender soluções profissionais com n8n e agentes de IA, mesmo sem programar!

O melhor é que tudo é mostrado passo a passo, focando sempre na aplicação real: desde a instalação do n8n, integrações avançadas até multiagentes trabalhando juntos e portfólio para apresentar a empresas. E você ainda ganha acesso vitalício, bônus exclusivos e tira dúvidas com a comunidade. Recomendo muito dar uma olhada:
Conheça a Formação Agentes de IA na Hora de Codar

Entendendo a estrutura de um Skill no Antigravity

Ao falar sobre a estrutura de um Skill no Antigravity, estamos nos referindo ao formato organizado e padronizado que todo Skill precisa seguir para funcionar corretamente na plataforma. O principal elemento é o arquivo SKILL.md, responsável por definir os pontos-chave de cada funcionalidade que você quer adicionar ao agente.

A estrutura básica de um Skill costuma conter:

1. Título da Skill: Ajuda na identificação rápida.
2. Descrição: Explica o propósito e o funcionamento daquela Skill para quem for utilizar.
3. Inputs (Entradas): Quais informações o agente precisa receber para executar a Skill.
4. Outputs (Saídas): O que se espera como resposta ou ação ao final do Skill.
5. Comandos e Exemplo de Uso: Como o usuário pode ativar a Skill dentro do Antigravity.

Por exemplo, imagine que você queira criar uma Skill para enviar uma mensagem automática no Slack: no SKILL.md estarão detalhados qual parâmetro de texto é esperado, qual canal usar e como será a resposta. Esse formato facilita tanto para quem cria quanto para quem utiliza, já que deixa tudo documentado e pronto para integração.

Outro ponto importante é que a clareza no SKILL.md ajuda na manutenção futura, na colaboração entre equipes e na escalabilidade dos projetos, pois outros usuários podem adaptar e evoluir ainda mais suas Skills com base em uma documentação bem feita.

Aprenda tudo sobre Skills no Antigravity

Neste vídeo mostro como você pode tirar o máximo proveito de skills, as melhores skills e também como criar as suas próprias

Diferença entre Skills globais e de workspace no Antigravity

Um aspecto relevante quando falamos sobre como criar Skills personalizados no Antigravity é entender a diferença entre Skills globais e Skills de workspace (também chamadas de Skills locais).

Skills globais: São aquelas disponíveis para todos os agentes e todos os workspaces dentro da sua instância Antigravity. Ou seja, depois de criada, qualquer usuário ou agente pode utilizá-la, independentemente do contexto. Essa abordagem é muito útil quando você tem funcionalidades que serão amplamente necessárias, como integrações com plataformas populares (ex: Slack, Notion) ou rotinas de automação comuns a todo o time.

Skills de workspace: Por outro lado, estas ficam restritas a um workspace ou ambiente específico. Elas só podem ser acessadas naquele contexto, normalmente para casos de automação particular, integração com sistemas internos ou fluxos muito customizados daquela equipe ou projeto. Isso ajuda a manter uma organização e evitar conflitos ou sobrecarga de comandos universais.

Quando usar cada uma?
Se a automação for relevante para vários times ou projetos, prefira o escopo global. Se for algo muito específico do seu fluxo ou para evitar expor comandos sensíveis, opte pelo workspace.

Essa distinção auxilia na escalabilidade do Antigravity, tornando a gestão mais fácil, segura e flexível conforme as necessidades do seu negócio ou dos seus times.

Passo a passo: como criar Skills personalizados no Antigravity

Criar Skills personalizados no Antigravity pode parecer desafiador à primeira vista, mas o processo é bem direto quando entendido o básico.

Veja um passo a passo simplificado:

1. Planeje o que você quer automatizar: Pense qual ação ou tarefa seu agente deveria executar com a nova Skill.
2. Estruture o arquivo SKILL.md: Como vimos, descreva a Skill de forma clara, indicando entradas, saídas e um exemplo de uso. Documente tudo pensando em como outros usuários utilizariam.
3. Desenvolva o código (se necessário): Para Skills mais avançadas, pode ser necessário programar algum script que realize a ação desejada. O Antigravity costuma aceitar scripts em linguagens populares como JavaScript ou Python.
4. Defina o escopo (global ou workspace): Escolha se essa Skill será útil para todos os agentes (global) ou apenas para um time/projeto (workspace).
5. Teste o Skill criado: Antes de disponibilizar, valide se está funcionando corretamente. Use situações reais ou crie exemplos de teste.
6. Implemente e compartilhe: Salve o arquivo na estrutura correta do Antigravity. Se for algo amplo, considere compartilhar com a comunidade.

Dica: sempre documente cada passo – isso facilita atualizações futuras e uso em equipes.

Esse método garante que suas Skills sejam úteis, organizadas e facilmente ajustáveis conforme os objetivos do seu negócio ou automações.

Hospede seus agentes e Skills com segurança e performance

Se você está levando a sério a criação de Skills personalizados e agentes, minha sugestão é hospedar seu ambiente no VPS da Hostinger. A vantagem é ter total controle, performance garantida, escalabilidade sob demanda e acesso aos nodes da comunidade do n8n. Dá para começar com planos enxutos e aumentar conforme o projeto cresce, tudo com suporte especializado e instalador automático. Ah, e usando o cupom HORADECODAR, você ainda recebe desconto especial!

Veja os planos e detalhes neste link: Contrate VPS Hostinger para n8n

Exemplos práticos de Skills para Antigravity

Para que você entenda na prática como criar Skills personalizados no Antigravity, veja alguns exemplos comuns e úteis para iniciantes.

1. Skill de envio de mensagem automática: Imagine que seu time precisa ser avisado toda vez que um pedido é finalizado em sua plataforma. Uma Skill pode ser criada para receber os dados do pedido e enviar uma mensagem no Slack de forma automática. Basta configurar os inputs (dados do pedido) e outputs (aviso enviado).

   
   

2. Skill de consulta em planilhas: Você pode criar uma Skill que, ao receber um termo de busca, retorna informações de uma planilha do Google Sheets. Isso é útil para consultas rápidas de cadastro, preços ou status de tarefas.

   
   

3. Skill de integração com API externa: Suponha que queira buscar o clima de uma cidade usando uma API pública. O Skill pede o nome da cidade e retorna a previsão do tempo.

   
   

Esses exemplos mostram que as possibilidades vão muito além do que se imagina! E o melhor: quanto mais você pratica, mais ideias para automatização aparecem.

Repare como, com poucos passos, é possível transformar tarefas repetitivas em processos automáticos e inteligentes. O segredo está em começar simples, testar bastante e, aos poucos, aprimorar suas Skills para Antigravity.

O que são Skills personalizados no Antigravity e por que usá-los?

Skills personalizados no Antigravity são conjuntos de funcionalidades programadas para estender as capacidades do agente. Eles permitem automatizar tarefas específicas, integrar novos comandos e adaptar o agente às necessidades do seu negócio ou fluxo de trabalho, tornando-o mais eficiente e direcionado.

Como funciona a estrutura do arquivo SKILL.md ao criar uma Skill personalizada?

O arquivo SKILL.md serve como documentação estruturada de cada Skill personalizada no Antigravity. Nele, você define o nome, descrição, exemplos de uso, parâmetros de entrada e saída, além de instruções e possíveis limitações. Isso facilita o entendimento, manutenção e colaboração durante o desenvolvimento das Skills.

Qual a diferença entre escopo global e workspace ao criar Skills personalizados no Antigravity?

O escopo global permite que a Skill esteja disponível para todos os workspaces dentro do Antigravity, ou seja, qualquer agente pode acessá-la. Já o escopo workspace limita o uso da Skill a um workspace específico, ideal para funções exclusivas ou dados sensíveis daquele ambiente.

Conclusão: personalize seu Antigravity e ganhe em produtividade

Dominar como criar Skills personalizados no Antigravity é um divisor de águas para quem quer automação sob medida e agentes de IA realmente potentes. Ao compreender a estrutura do SKILL.md, quando criar Skills globais ou de workspace e explorar exemplos práticos, você transforma sua rotina e agiliza processos. Não se esqueça de testar, documentar e buscar inspiração: seja na comunidade, em cursos como a Formação Agentes de IA ou hospedando com qualidade na Hostinger. Experimente, personalize e comprove na prática como o Antigravity pode ser ainda mais poderoso para você e seu negócio!

Onde ficam salvas as Skills no Antigravity (os caminhos):

Quando a gente fala de escopo, no fim das contas é uma questão de PASTA

Skill de workspace (do projeto) vai na pasta .agents/skills/ dentro da raiz do teu projeto, cada skill na sua subpasta

Como ela mora no projeto, tu pode commitar no repositório e todo mundo do time passa a ter a skill à disposição (versões mais antigas ainda aceitam o caminho legado .agent/skills)

Skill global (pessoal) vai em ~/.gemini/antigravity/skills/, e essa te acompanha em todos os projetos da tua máquina

E se existir uma skill de MESMO nome nos dois lugares? A do workspace ganha, ou seja, o projeto sobrescreve a global

Então a regra prática é: skill que faz sentido só naquele projeto vai pro workspace, utilidade que tu usa em tudo vai pra global

Onde achar as melhores Skills prontas pro Antigravity:

Uma das coisas mais massa é que tu não precisa criar tudo do zero

O formato SKILL.md segue um padrão aberto (Agent Skills), então uma skill escrita pra um agente costuma servir pra outros também: Claude Code, Cursor, Codex CLI, Gemini CLI e por aí vai

Na prática isso quer dizer que dá pra pegar uma skill boa que alguém publicou, jogar na tua pasta .agents/skills/ ou ~/.gemini/antigravity/skills/ e já sair usando

Bora um conselho de quem tá testando: comece reaproveitando skills de tarefas repetitivas (revisão de segurança, checagem de SEO, performance, script de deploy) e só depois parte pra escrever as tuas do zero

Um detalhe que muda tudo: a skill não fica ocupando o contexto do agente o tempo todo

No começo da sessão o Antigravity lê só o cabeçalho da skill (aquele name e o description)

O corpo com as instruções em markdown só é carregado quando o agente percebe que a tarefa atual tem a ver com aquela skill

Por isso o description é tão importante: é ele que o Antigravity usa pra decidir se puxa a skill ou não, então escreve um resumo claro do que ela faz

Testei as Skills assim que saíram no Antigravity e a real é que o negócio é mais simples do que o nome assusta

No fim das contas a skill é um arquivo markdown, um texto formatado com as instruções que tu quer que o agente siga, e é isso que facilita o Antigravity entender o que executar

O que mais me pegou foi parar de repetir prompt gigante: aquele prompt enorme de revisão de segurança que eu vivia salvando no bloco de notas virou uma skill global no meu PC, e agora eu aciono ela em qualquer projeto

Skill boa pra começar, do que eu venho usando: verificar segurança do projeto, checar SEO, olhar performance e montar script de deploy, tudo aquilo que se repete de projeto pra projeto

E tem o lado equipe: quando a skill é bem específica de um projeto, eu deixo ela no próprio repositório e quem trabalha comigo já usa também

Se quiser ver isso na prática eu mostro tudo no vídeo aqui embaixo, inclusive fontes confiáveis pra reaproveitar skills de graça