Cómo usar Skills en OpenCode

Guía completa del sistema de Skills: qué son, cómo cargarlos, cómo crearlos y cómo sacarles el máximo partido en tus proyectos.

¿Qué son los Skills?

Los Skills son instrucciones reutilizables que le dan a la IA conocimiento experto sobre una tarea concreta. Son como plugins de conocimiento: cargas un skill y la IA sabe inmediatamente cómo diseñar un banner, escribir un test, auditar seguridad o generar una presentación.

Cada skill es un archivo SKILL.md con instrucciones detalladas, ejemplos, referencias y en algunos casos scripts auxiliares. Al activarlo, el contenido del skill se inyecta en el prompt del agente, dándole contexto especializado sin que tú tengas que explicar nada.

Arquitectura

Los skills siguen una estructura modular:

• SKILL.md — el archivo principal con instrucciones, ejemplos y referencias
• scripts/ — opcional, contiene herramientas auxiliares (búsqueda BM25, validación)
• data/ — opcional, datasets CSV con patrones de diseño, estrategias, etc.
• assets/ — opcional, imágenes, templates, recursos estáticos

Cómo cargar un Skill

Hay dos formas de activar un skill:

1. Desde el chat (tool call)

Usa la herramienta skill directamente en la conversación. El agente cargará el skill y lo tendrá disponible para el resto de la sesión:

# El agente detecta automáticamente cuándo activar un skill
# Pero también puedes pedirlo explícitamente:

"Usa el skill de diseño para crear un banner"
"Carga el skill de Supabase para ayudarme con la migración"
"Activa el skill de Node.js backend patterns"

2. Desde el sistema (AGENTS.md / CLAUDE.md)

Puedes referenciar skills en tu archivo de instrucciones del proyecto. Cuando la IA arranque, cargará los skills automáticamente:

# En AGENTS.md o CLAUDE.md:
Usa el skill de frontend-design para cualquier tarea de UI.
Usa el skill de supabase cuando trabajes con la base de datos.

Esta es la forma más potente: configúralo una vez y la IA sabrá qué skills usar según la tarea, sin que tengas que pedirlo cada vez.

Estructura de un SKILL.md

Cada skill tiene una estructura clara en secciones:

• Metadatos — nombre, descripción corta, cuándo activarlo
• Instrucciones — guía paso a paso de cómo ejecutar la tarea
• Ejemplos — casos de uso reales con código
• Referencias — enlaces a documentación, recursos externos
• Scripts — herramientas auxiliares (búsqueda, validación, generación)

Crear tu propio Skill

Los skills se guardan en .agents/skills/ o .claude/skills/. Para crear uno nuevo:

1. Crea una carpeta con el nombre de tu skill: .agents/skills/mi-skill/
2. Crea el archivo SKILL.md con las instrucciones
3. (Opcional) Añade scripts o datasets en subcarpetas scripts/ y data/
4. El skill estará disponible al instante — solo menciónalo en el chat o en AGENTS.md

Ejemplo mínimo de SKILL.md

# Mi Skill

## Descripción
Haz X cuando ocurra Y.

## Instrucciones
1. Paso uno
2. Paso dos
3. Paso tres

## Ejemplos
```
Código de ejemplo
```

## Referencias
- Documentación relevante
- Enlaces útiles

Dónde se guardan los Skills

Los skills pueden estar en tres ubicaciones, cada una con un propósito diferente:

• ~/.agents/skills/ — skills globales del usuario, disponibles en todos los proyectos
• ~/.claude/skills/ — skills globales de Claude, compatibles con Claude Code
• .claude/skills/ y .opencode/skills/ — skills del proyecto, solo disponibles en ese repositorio

Esta jerarquía permite tener skills generales (como diseño o Supabase) siempre disponibles, y skills específicos del proyecto (como "cómo desplegar esta app" o "convenciones de este equipo") solo en el repo correspondiente.

Reutilización entre skills

Si tienes skills solapados (ej: design y banner-design comparten sistema de tokens), puedes referenciar uno desde otro en el SKILL.md:

## Dependencias
Este skill complementa a `design`.
Carga `ui-styling` si necesitas código frontend.

La IA entenderá que debe cargar múltiples skills si la tarea lo requiere.