Las Agent Skills son la forma más potente de dotar a tu agente de Antigravity de experiencia especializada — pero configurarlas correctamente es donde la mayoría de los desarrolladores encuentran dificultades. Esta guía te explica todo: instalar paquetes de skills de la comunidad
Get the latest on AI, LLMs & developer tools
New MCP servers, model updates, and guides like this one — delivered weekly.
If you want the theory behind Agent Skills (three-level loading, progressive disclosure, the open standard), see our Mastering Agent Skills deep dive. This article is the practical "hands-on-keyboard" companion.
1. Skills vs Rules vs Workflows: What Goes Where
Before installing anything, you need to understand Antigravity's three configuration layers. Putting instructions in the wrong place is the most common reason skills don't work as expected.
GEMINI.md (Rules)
The agent's personality and behavior. Always-loaded instructions for coding standards, style guides, and project-wide rules. Apply to every prompt.
Use when: guidance applies to every single interaction
Skills (SKILL.md)
The agent's specialized toolbox. Loaded on-demand when the agent detects a matching task. Contain step-by-step procedures, scripts, and domain knowledge.
Use when: a situational "superpower" is needed
AGENTS.md
The cross-tool constitution. Coding conventions and behavior rules that work across Antigravity, Claude Code, Cursor, and other AI tools.
Use when: standards should be portable across tools
The decision rule: If it applies to every prompt, put it in GEMINI.md. If it's a repeatable capability for specific tasks, make it a Skill. If it should work across multiple AI tools, use AGENTS.md. For a deep dive on AGENTS.md, see our AGENTS.md guide.
2. How Skills Actually Work: Progressive Disclosure
Skills use a three-level loading system that keeps your agent fast even with hundreds installed. This is critical to understand before you start adding skills — it explains why well-structured skills have near-zero performance cost while poorly structured ones can tank your agent.
Level 1: METADATA (Always Loaded)
Only the YAML frontmatter (name + description)
~20-50 tokens por skill. Costo de rendimiento cero.
Nivel 2: INSTRUCCIONES (Cargadas al activarse)
Cuerpo completo de SKILL.md cargado cuando la tarea coincide
El agente lee a través del sistema de archivos. 200-2,000 tokens.
Nivel RESOURCES (Loaded as Needed)
Scripts, templates, schemas stay on disk
Only script OUTPUT enters context. Heavy assets stay out.
RESULT: 100 skills installed = ~5,000 tokens overhead (metadata only)
Only the triggered skill adds full instructions to context
This means you can safely install dozens of skills without worrying about bloating your agent's context window. The agent reads skill descriptions to decide what's relevant, then loads only what it needs. For more on how context and tokens work in Antigravity, see our token optimization guide.
3. Installing Skills: Three Methods
Method 1: The Awesome Skills Installer (Recommended)
The community-maintained Antigravity Awesome Skills repository is the largest collection, with over 1,340 skills covering everything from code review to database management to deployment automation. It has over 29,000 GitHub stars and is the standard starting point.
# Default: installs all 1,340+ skills globally
npx antigravity-awesome-skills
# Tool-specific install (targets known skill directories)
npx antigravity-awesome-skills --antigravity
npx antigravity-awesome-skills --claude
npx antigravity-awesome-skills --cursor
npx antigravity-awesome-skills --gemini
# Install to a custom path
npx antigravity-awesome-skills --path ~/.my-skills/
Installing all 1,340+ skills at once can cause 10–15 minute loading times on the first agent initialization, as reported by community members. The agent needs to read and index every SKILL.md metadata block. See the Performance section below for how to manage this.
Method 2: Manual Installation (Selective)
For targeted setups, clone individual skill repositories and symlink them into your skills directory:
# Create skills directory (if it doesn't exist)
mkdir -p ~/.gemini/antigravity/skills
# Clone a skill repo
git clone https://github.com/user/my-skill.git ~/skills-repos/my-skill
# Crear un enlace simbólico (symlink) en el directorio global de skills
ln -s ~/skills-repos/my-skill ~/.gemini/antigravity/skills/my-skill
# O copiar en el workspace de un proyecto
cp -r ~/skills-repos/my-skill ./.agent/skills/my-skill
Método 3: Skills con alcance de Workspace
Para skills específicos del proyecto (scripts de despliegue, boilerplate de frameworks, etc.), colócalos en el directorio .agent/skills/ de tu proyecto. Estos solo están disponibles dentro de ese workspace y son ideales para skills compartidos en equipo y guardados en el control de versiones.
Global (todos los proyectos):
~/.gemini/antigravity/skills/<skill-name>/SKILL.md
Workspace (solo este proyecto):
./.agent/skills/<skill-name>/SKILL.md
Prioridad: Los skills de Workspace anulan los skills globales con el mismo nombre
4. Soluciones de configuración para WSL2 y Windows
Los usuarios de Windows y WSL2 enfrentan la mayor fricción en la configuración. Aquí están las soluciones verificadas para cada error común:
Solución: Los Skills no cargan en WSL2
El problema más común en WSL2 es que los skills se instalan en el sistema de archivos de Windows en lugar del sistema de archivos de Linux. Antigravity ejecutándose dentro de WSL2 no puede acceder a /mnt/c/Users/... las rutas de manera eficiente — la E/S de archivos a través del límite es extremadamente lenta.
/mnt/c/Users/you/.gemini/antigravity/skills/
CORRECTO (ruta nativa de Linux dentro de WSL2)
~/.gemini/antigravity/skills/
# Solución: mover los skills al sistema de archivos nativo de Linux
mv /mnt/c/Users/you/.gemini ~/.gemini
Solución: El Agent se queda cargando después de instalar un skill
Si el agent se bloquea durante la inicialización después de instalar skills, la solución más confiable es reiniciar WSL por completo:
wsl --shutdown
# Luego vuelve a abrir tu terminal de WSL y reinicia Antigravity
Solución: Errores de OAuth / Autenticación en WSL2
Los relojes de WSL2 a menudo se desincronizan cuando una laptop entra en suspensión, lo que provoca que los tokens de OAuth de Google sean rechazados por estar expirados. Esto se manifiesta como fallos repentinos de autenticación después de que el equipo se reactiva:
sudo hwclock -s
# O forzar la sincronización NTP
sudo ntpdate time.google.com
Solución: El Modo Sandbox bloquea los Skills (v1.21.6)
La actualización v1.21.6 introdujo el sandboxing en Linux que puede evitar que los skills ejecuten scripts. Si los scripts de tus skills fallan con errores de permisos después de la actualización, consulta nuestra guía de solución para v1.21.6 para la alternativa del sandbox.
5. Las 10 habilidades principales para desarrolladores web
Estas son las habilidades más útiles para el desarrollo web frontend y full-stack, basadas en la adopción de la comunidad y el feedback de los desarrolladores:
| # | Habilidad | Qué hace |
|---|---|---|
| 1 | code-review | Revisión de código automatizada con comprobaciones de seguridad, rendimiento y estilo |
| 2 | nextjs-patterns | Convenciones de App Router, server components y mejores prácticas de la API de metadatos |
| 3 | tailwind-architect | Genera layouts responsivos con consistencia en el sistema de diseño |
| 4 | accessibility-audit | Comprobaciones de cumplimiento de WCAG 2.1, atributos ARIA y navegación por teclado |
| 5 | git-conventional | Aplica el formato de Conventional Commits con validación de alcance |
| 6 | api-design | Scaffolding de endpoints REST y GraphQL con generación de especificaciones OpenAPI |
| 7 | test-generator | Crea pruebas unitarias y de integración con aserciones compatibles con el framework |
| 8 | seo-optimizer | Meta tags, datos estructurados, sitemap y guía de Core Web Vitals |
| 9 | docker-compose | Genera y valida configuraciones de Docker para stacks web |
| 10 | license-header | Añade y gestiona encabezados de licencia en todos los archivos de origen |
6. Las 10 habilidades principales para desarrolladores de Backend & Sistemas
| # | Habilidad | Qué hace |
|---|---|---|
| 1 | db-schema-validator | Valida migraciones de bases de datos contra restricciones de esquema con scripts de Python |
| 2 | security-scanner | Comprobaciones del top 10 de OWASP, auditoría de dependencias y detección de secretos |
| 3 | terraform-patterns | Scaffolding de infraestructura como código con mejores prácticas de módulos |
| 4 | go-patterns | Go idiomático con manejo de errores, concurrencia y patrones de prueba |
| 5 | k8s-manifests | Generación de manifiestos de Kubernetes para deployment, service e ingress |
| 6 | rust-patterns | Generación de código con soporte para ownership y guía de lifetime y trait |
| 7 | ci-pipeline | Configuración de pipelines de GitHub Actions y GitLab CI/CD |
| 8 | sql-optimizer | Análisis de consultas, recomendaciones de índices y revisión de planes de ejecución |
| 9 | monitoring-setup | Scaffolding de configuración para Prometheus, Grafana y alertas |
| 10 | adk-tool-scaffold | Generación de herramientas de Google Agent Development Kit con plantillas y ejemplos |
7. Cómo crear tu propia Skill personalizada
Crear una skill personalizada toma unos 5 minutos. Una skill es simplemente un directorio con un SKILL.md file — everything else is optional. Here's the complete anatomy:
my-skill/
SKILL.md # Required: metadata + instructions
scripts/ # Optional: Python, Bash, Node executables
references/ # Optional: templates, docs, schemas
assets/ # Optional: images, logos
examples/ # Optional: input/output demonstrations
The SKILL.md Format
Every SKILL.md has two parts: YAML frontmatter for machine discovery, and a Markdown body for human-readable instructions.
---
name: my-deployment-skill
description: Deploy the current project to staging or
production via SSH. Use when user says "deploy"
or "ship to staging".
---
# Deployment Skill
## Goal
Deploy the current project to the target environment.
## Steps
1. Read the target from user input ("staging" or "prod")
2. Run `bash scripts/deploy.sh [target]`
3. Informar el estado del despliegue a partir del código de salida del script
## Restricciones
- NUNCA desplegar a prod sin confirmación explícita del usuario
- Ejecutar siempre las pruebas antes de desplegar
- Si deploy.sh termina con el código 1, informar el error
- La descripción es el activador: El agente vincula la intención del usuario con las descripciones de las skills. Escribe descripciones específicas y accionables ("Desplegar en staging vía SSH"), no vagas ("Herramientas de despliegue").
- Keep scripts atomic: Each script should do one thing. Let the agent orchestrate multiple scripts rather than writing monolithic bash files.
- Offload static content: Large schemas, templates, and documentation should go in
references/— not in the SKILL.md body — to avoid token waste. - Include constraints: Tell the agent what NOT to do. Safety rules and guardrails prevent the agent from taking dangerous actions.
- Exit codes matter: Scripts should return exit code 0 for success and 1 for failure. The agent uses these to determine next steps.
Five Skill Patterns (Progressive Complexity)
- Instructions-Only: Pure Markdown instructions, no scripts. Great for coding standards and formatting rules (e.g., Conventional Commits enforcer).
- Asset-Based: Instructions + template files in
references/. Good for license headers, boilerplate generation, and scaffolding. - Few-Shot Learning: Instructions + example input/output pairs in
examples/. Effective for type conversion (JSON to Pydantic) and format transformation. - Script-Based: Instructions + deterministic scripts for validation, testing, or data processing. Best for tasks that require reliable, repeatable execution.
- Full Composite: Combines templates, scripts, examples, and references. Used for complex workflows like the ADK tool scaffold generator.
8. Performance: Keeping Your Agent Fast
The most common performance complaint is agent initialization slowing down after installing many skills. Here's what actually causes it and how to fix it.
The 1,300 Skills Problem
Community members have reported that installing the full Awesome Skills library (1,340+ skills) caused agent initialization to take 10–15 minutes on first load. This happens because the agent needs to read and index the YAML metadata from every SKILL.md file during startup.
Optimization Strategies
- Install selectively: Use tool-specific flags (
--antigravity,--claude) o instala paquetes de habilidades individuales en lugar de la librería completa. - Usa el alcance del espacio de trabajo para las habilidades del proyecto: Las habilidades en
.agent/skills/solo se cargan para ese proyecto, manteniendo la rapidez en otros proyectos. - Realiza auditorías regularmente: Elimina las habilidades que no uses. Ejecuta
ls ~/.gemini/antigravity/skills/ | wc -lpara ver cuántas tienes instaladas. - Calidad sobre cantidad: 20–30 habilidades bien elegidas superarán a 1,300 genéricas. El agente empareja mejor con descripciones más específicas y en menor cantidad.
- Optimiza
.antigravityignore: Asegúrate de que tu archivo ignore excluya los directoriosnode_modules,.git,dist, ybuild. Esto reduce el tiempo de indexación para las habilidades del espacio de trabajo. Para ver una lista completa de qué ignorar, consulta nuestra guía de optimización de carga de agentes.
10-30 habilidades Óptimo. Carga rápida, emparejamiento preciso.
30-100 habilidades Bien. Sobrecarga mínima por la carga de metadatos.
100-500 habilidades Retraso notable en la primera carga (30-120 segundos).
500+ habilidades Espera de 5 a 15 min para la primera inicialización. Considera depurar.
9. Guía de decisión: Skills vs GEMINI.md vs AGENTS.md
Aquí tienes la matriz de decisión definitiva sobre dónde colocar las instrucciones de tu agente. Mejores prácticas de la comunidad del Google AI Developer Forum:
| Pregunta | Respuesta | Uso |
|---|---|---|
| ¿Se aplica a cada prompt? | Sí | GEMINI.md |
| ¿Capacidad situacional? | Sí | Skill |
| ¿Debería funcionar también en Cursor/Claude? | Sí | AGENTS.md |
| ¿Conocimiento profundo del dominio / especificaciones de API? | Sí | Base de conocimientos |
| ¿Necesita scripts o automatización? | Sí | Skill + scripts/ |
| ¿Estándares de codificación para todo el equipo? | Sí | AGENTS.md (hacer commit al repo) |
Para más información sobre la configuración de GEMINI.md, consulta nuestra guía de Antigravity Rules con más de 50 ejemplos. Para estándares entre herramientas, consulta la guía de AGENTS.md.
A medida que tu configuración crezca, crea una skill "config-layer-audit" que compare tus archivos GEMINI.md, AGENTS.md y las skills instaladas para detectar solapamientos, conflictos y vacíos. Esto evita que las instrucciones de una capa contradigan a otra.