Si hay una tarea que repites en cada proyecto y siempre se la explicas igual a tu agente, las skills en Antigravity son la forma de dejársela aprendida de una vez. Son carpetas con instrucciones que el agente carga solo cuando hacen falta, así repite ese trabajo siguiendo tus reglas sin que se lo dictes cada vez.
Documentar funciones, lanzar los tests, generar código repetitivo o dar formato a tus commits son justo el tipo de tareas que encajan aquí. Además, no recargas el contexto del agente para conseguirlo, porque cada skill se mantiene al margen hasta que su tarea aparece.
Monta tu primera skill de principio a fin con este tutorial y mírala activarse sola en cuanto le lances la tarea.
Una skill es una de las formas de personalizar el editor con agentes de Antigravity, y le enseña a tu agente a hacer una tarea concreta como tú quieres. La escribes una vez en una carpeta y, en lugar de repetir las mismas indicaciones en cada prompt, el agente la reutiliza siempre que viene al caso.
El ahorro de contexto está en cómo se cargan esas instrucciones. Si cargas de golpe todo tu código, tu documentación y tus herramientas en el contexto, el agente se satura y se ralentiza con datos que no necesita para la tarea que tiene delante. Con una skill no pasa, porque al principio solo ve un breve resumen de cada una y carga las instrucciones completas únicamente cuando hacen falta.
Ese momento lo decide el propio agente, que compara tu petición con la descripción de cada skill disponible, equipa la que encaja y la libera al terminar, de modo que el contexto se mantiene ligero entre una tarea y otra.
La diferencia con las reglas y los flujos de trabajo está en quién manda. Las reglas son guardarraíles siempre activos, como exigir TypeScript estricto, y los flujos los lanzas tú a mano con un comando del tipo /test. La skill, en cambio, la activa el propio agente cuando interpreta tu intención, sin que tengas que invocarla.
Todo se reduce a una carpeta con un nombre descriptivo, un archivo obligatorio y unas cuantas subcarpetas opcionales que solo añades si las necesitas. Este es el esqueleto que vas a replicar en cada skill que crees, y coincide con la estructura que define la documentación oficial de Antigravity.
mi-skill/
├── SKILL.md # Obligatorio. Metadatos e instrucciones
├── scripts/ # Opcional. Scripts en Python, Bash o Node
├── references/ # Opcional. Documentación o plantillas
└── assets/ # Opcional. Imágenes u otros recursos
El archivo SKILL.md es el cerebro y tiene dos partes. La primera es el frontmatter en YAML, un bloque de metadatos al inicio del archivo. Ahí la descripción es el campo que decide si tu skill se activa, porque es lo único que el agente compara con tu petición, y el nombre es opcional, que si lo dejas en blanco toma el de la carpeta.
La segunda es el cuerpo en Markdown, donde van las instrucciones reales con un formato de texto sencillo. Aquí explicas el objetivo, los pasos que debe seguir el agente, algún ejemplo de entrada y salida y las restricciones del tipo no borrar datos, y ese texto se inyecta en el contexto solo cuando la skill se activa.
El sitio donde guardas la carpeta decide quién puede usar la skill. Si la dejas en <raíz-del-proyecto>/.agents/skills/ queda disponible solo en ese proyecto, ideal para tareas de una app concreta, y si la pones en ~/.gemini/antigravity/skills/ la tienes disponible en todos tus proyectos, que es lo que te conviene para utilidades genéricas que usas siempre.
El recorrido es corto y siempre el mismo, vas de una tarea repetitiva a una skill funcionando, y conviene seguir los pasos en orden hasta la prueba final, porque cada uno se apoya en el anterior y es esa última comprobación la que confirma que todo encaja.
Empieza por una tarea que repitas y que siempre quieras resolver igual, ya sea documentar funciones con un formato fijo, lanzar tu batería de tests, generar código repetitivo como modelos de datos o dar formato a tus commits siguiendo una convención.
Escoge una sola y mantenla acotada, una skill que documenta funciones rinde mejor que una que pretende documentar, testear y formatear a la vez.
Según el alcance que decidiste, crea la carpeta en la ruta que le toca, la del proyecto si la skill es solo para esa app o la global si la quieres en todos tus proyectos.
Dale un nombre claro en minúsculas y con guiones, por ejemplo git-commit-formatter, que el agente usará como respaldo si luego no defines un nombre en los metadatos.
Dentro de la carpeta crea el archivo SKILL.md y abre el frontmatter en YAML con tres guiones, los metadatos y otros tres guiones de cierre. Dedica tu mejor esfuerzo a la descripción, porque es la frase que dispara la skill, así que una vaga como herramientas de git no sirve. Concreta cuándo debe activarse, como en este ejemplo.
---
name: git-commit-formatter
description: Da formato a los mensajes de commit según la convención Conventional Commits. Úsala cuando el usuario pida confirmar cambios o escribir un mensaje de commit.
---
Debajo del frontmatter escribe en Markdown lo que el agente debe hacer, y estructura el cuerpo con un objetivo, los pasos concretos, algún ejemplo y las restricciones. Sé directo y específico, como si le explicaras la tarea a alguien que entra nuevo al equipo y no conoce tus manías.
# Formateador de commits
Cuando escribas un mensaje de commit, sigue la convención Conventional Commits.
## Formato
tipo[ámbito opcional]: descripción
## Instrucciones
1. Analiza los cambios para decidir el tipo, como feat, fix o docs.
2. Añade el ámbito si aplica, por ejemplo el componente afectado.
3. Escribe la descripción en imperativo, "añade login" y no "añadido login".
Cuando una tarea necesita más que instrucciones, por ejemplo ejecutar una comprobación exacta, guarda un script en scripts/ y referéncialo por su ruta desde el SKILL.md, así el agente lo ejecuta en lugar de improvisar.
Para un texto fijo, como una cabecera de licencia, guárdalo en references/ y pídele que lo lea solo cuando haga falta. Sacar la lógica y los textos pesados del archivo de instrucciones mantiene la skill ligera y evita erratas al copiar textos largos a mano.
Llega la comprobación final, así que abre el chat de Antigravity y lanza una petición en lenguaje natural relacionada con tu skill, por ejemplo pídele que confirme unos cambios. Si todo está bien, el agente activará tu skill por su cuenta antes de responder y aplicará tus instrucciones en lugar de resolver a su manera.
Si no la reconoce, revisa la descripción del frontmatter y hazla más explícita sobre cuándo usarla, que en nuestra experiencia suele ser lo primero que conviene mirar, y vuelve a lanzar el prompt para confirmar que ya salta.
Con esto ya sabes qué es una skill, cómo se organiza por dentro y cómo crear la tuya hasta dejarla funcionando, así que a partir de aquí puedes ir armando tu propia biblioteca y convertir cada tarea que repites en algo que tu agente resuelve siguiendo tus reglas.
Si lo que te apetece es aprender a programar describiendo lo que quieres, échale un vistazo al curso gratuito de Vibe Coding con Claude Code y empieza a construir con agentes desde cero.
Descubre lo que puedes crear en 7 días, sin saber programar
Cada día, un proyecto que podrás construir sin escribir una sola línea de código, directo a tu bandeja de entrada.
Empieza Gratis
Academia de herramientas no-code y low–code
.svg){kind=icon}
