Google Antigravity: Skills, MCP Servers y Hooks explicados para dummies

Los Skills, los MCP Servers, los Hooks y las Rules son lo que convierte a Antigravity de un asistente genérico en una herramienta especializada para tu proyecto. Esta guía explica qué es cada uno, para qué sirve, y cómo configurarlos sin complicarte la vida.

Si aún estás aprendiendo los fundamentos, empieza por cómo usar Google Antigravity paso a paso.

Skills: slash commands especializados para tu agente

Un Skill es un archivo SKILL.md con instrucciones que el agente sigue cuando detecta que son relevantes para tu tarea. Una vez creado, se convierte automáticamente en un slash command (por ejemplo,/code-review o /deploy).

Son la forma de darle al agente procedimientos estándar de tu equipo sin tener que explicarlos cada vez.

Dónde guardar los Skills

• Skills de proyecto (solo para ese repositorio): .agents/skills/nombre-del-skill/SKILL.md
• Skills globales (disponibles en todos tus proyectos): ~/.gemini/config/skills/nombre-del-skill/SKILL.md

Cómo crear un Skill

Crea la carpeta y el archivo SKILL.md:

.agents/skills/mi-skill/SKILL.md

El archivo debe tener frontmatter YAML al inicio:

---
name: mi-skill
description: Hace X cuando necesitas Y. Úsalo para Z.
---

# Mi Skill

Instrucciones detalladas para el agente...

La description es lo que el agente lee para decidir si aplica el skill o no. Escríbela clara: "Genera tests unitarios para funciones Python usando pytest" es mejor que "tests".

Puedes incluir scripts y recursos adicionales en la carpeta del skill. El agente puede usarlos cuando sigue las instrucciones.

Rules: restricciones y guías persistentes

Las Rules son archivos Markdown con restricciones que el agente siempre sigue. Son más estrictas que los Skills — no son opcionales según el contexto, son reglas.

Hay cuatro tipos de activación:

• Always On: se aplica en todas las conversaciones.
• Manual: se activa cuando la mencionas con @nombre-de-la-regla en el prompt.
• Model Decision: el agente decide si aplica la regla basado en la descripción.
• Glob: se activa para archivos que coincidan con un patrón (como *.ts o src/**/*.py).

Dónde guardarlas:

• Proyecto: .agents/rules/nombre-regla.md
• Global: ~/.gemini/GEMINI.md

MCP Servers: conectar el agente con tus herramientas

MCP (Model Context Protocol) es el estándar abierto que permite a Antigravity conectarse con herramientas externas: bases de datos, APIs, servicios cloud, herramientas internas. Un servidor MCP expone capacidades que el agente puede usar durante la conversación.

MCP Store integrado

Antigravity tiene una tienda de servidores MCP dentro de la app. Para acceder:

• Haz clic en "..." en la parte superior del panel del agente y selecciona "MCP Store".
• Busca el servidor que necesitas (Supabase, Linear, Notion, etc.).
• Haz clic en Install y sigue las instrucciones de autenticación.

Servidores disponibles en la tienda incluyen: Supabase, Firebase, GitHub, Linear, Notion, BigQuery, MongoDB, Stripe, Netlify, Heroku, Figma, Jira (Atlassian), Postman, Prisma, Redis, Neon, y más de 30 opciones adicionales.

Agregar un MCP server personalizado

Para conectar un servidor propio o uno que no esté en la tienda:

• Ve a "..." → "Manage MCP Servers" → "View raw config".
• Edita el archivo mcp_config.json:

{
  "mcpServers": {
    "mi-api": {
      "command": "node",
      "args": ["/ruta/a/mi-servidor-mcp.js"],
      "env": {
        "API_KEY": "tu-api-key"
      }
    }
  }
}

Para servidores remotos usa serverUrl (no url — ese formato es legado y ya no funciona):

{
  "mcpServers": {
    "mi-api-remota": {
      "serverUrl": "https://mi-api.com/mcp/",
      "headers": {
        "Authorization": "Bearer TOKEN"
      }
    }
  }
}

Build with Google: bundles preconfigurados

Antigravity incluye bundles de Skills + MCP Servers preconfigrados para stacks de Google específicos. Activarlos es un checkbox en configuración:

• Firebase Bundle: Skills para Firestore, Authentication, App Hosting, Cloud Functions. El agente puede crear reglas de seguridad, gestionar usuarios y hacer deploy directamente.
• Android CLI: herramientas para desarrollo Android. Crear proyectos, desplegar en emulador, migrar a las últimas versiones de bibliotecas.
• Chrome DevTools: debugging de accesibilidad, Core Web Vitals, tests visuales, diagnóstico de memory leaks vía Puppeteer.
• Modern Web Guidance: mejores prácticas actualizadas de web moderna para que el agente genere código accesible, rápido y seguro.
• Antigravity SDK Bundle: referencias y ejemplos del SDK de Python de Antigravity para construir agentes personalizados.
• Science (DeepMind): skills especializados para flujos de trabajo científicos de biología y química.

Para activar: Settings → Customizations → Build with Google Plugins.

Hooks: automatizar en respuesta a eventos

Los Hooks son scripts de shell que se ejecutan en puntos específicos del ciclo de ejecución del agente. Son útiles para validaciones automáticas, logs, o acciones post-ejecución.

Se configuran en un archivo hooks.json:

• PreToolUse: se ejecuta antes de que el agente use una herramienta. Puedes usarlo para validar o bloquear acciones.
• PostToolUse: se ejecuta después de que el agente usa una herramienta. Útil para disparar linters o formatters.
• PreInvocation: se ejecuta antes de que el agente llame al modelo. Puedes inyectar contexto adicional automáticamente.
• PostInvocation: se ejecuta después de los tool calls. Puede forzar que el loop continúe o se detenga.
• Stop: se ejecuta cuando el agente termina. Útil para notificaciones o para actualizar logs.

Ejemplo de hook que corre un linter después de cada edición:

{
  "linter": {
    "PostToolUse": [{
      "matcher": "write_to_file",
      "hooks": [{
        "type": "command",
        "command": "npm run lint",
        "timeout": 15
      }]
    }]
  }
}

Plugins: empaquetar todo junto

Un Plugin es un bundle que agrupa Skills, Rules, MCP Servers y Hooks en un solo paquete deployable. Es útil para compartir configuraciones entre proyectos o con tu equipo.

Estructura de un plugin:

.agents/plugins/mi-plugin/
├── plugin.json
├── mcp_config.json
├── hooks.json
├── skills/
│   └── mi-skill/
│       └── SKILL.md
└── rules/
    └── mi-regla.md

En resumen

Skills = procedimientos que el agente sigue. Rules = restricciones que siempre respeta. MCP Servers = conexión con tus herramientas. Hooks = automatización en respuesta a eventos del agente. Plugins = todo junto en un paquete.

El siguiente nivel es aprender a orquestar múltiples agentes en paralelo. Lee cómo usar subagentes y tareas paralelas en Antigravity.