OpenCode Skills

Que son los Skills?

Los Skills son conjuntos de instrucciones reutilizables que el agente de IA descubre y ejecuta automaticamente cuando detecta que son relevantes para la tarea. Piensa en ellos como "recetas especializadas" que le ensenan a OpenCode como manejar tareas especificas.

Estructura de un Skill

Un skill es una carpeta que contiene un archivo SKILL.md. Eso es todo. Sin compilacion, sin herramientas especiales.

.opencode/
  skills/
    mi-skill/
      SKILL.md          <- Archivo principal (obligatorio)
      referencia.md     <- Archivos auxiliares (opcional)
      script.sh         <- Scripts (opcional)

El archivo SKILL.md

Tiene dos partes: un frontmatter YAML con metadatos y el contenido con instrucciones para el agente.

---
name: test-generator
description: Genera tests unitarios para archivos TypeScript. Usar cuando el usuario pida crear tests o cobertura de codigo.
---

# Generador de Tests

## Pasos a seguir
1. Lee el archivo fuente indicado
2. Identifica las funciones exportadas
3. Crea un archivo de test usando vitest
4. Incluye casos edge y manejo de errores

## Ejemplo de output
Usa `describe()` e `it()` con nombres descriptivos.

Campos del Frontmatter

Donde colocar los Skills

OpenCode busca skills en varias ubicaciones, de menor a mayor alcance:

Como crear tu primer Skill

1. Crea la carpeta
   mkdir -p .opencode/skills/test-generator
2. Crea el archivo SKILL.md
   Escribe el frontmatter con name y description, luego las instrucciones para el agente.
3. Reinicia OpenCode
   Los skills se cargan al inicio. Usa /new o reinicia la sesion.
4. Prueba!
   Simplemente escribe algo como "genera tests para src/auth.ts" y el agente cargara el skill automaticamente.

Ejemplo Practico: Skill de Revision de Seguridad

---
name: security-review
description: Revisa codigo en busca de vulnerabilidades de seguridad OWASP. Usar cuando el usuario pida revisar seguridad, auditar modulo o detectar fallas.
---

# Revision de Seguridad

## Protocolo
1. Identifica puntos de entrada de datos del usuario
2. Busca inyecciones SQL, XSS, CSRF
3. Revisa autenticacion y autorizacion
4. Verifica que secrets no esten hardcodeados
5. Emite reporte con severidad (critico/alto/medio/bajo)

## Reglas
- Nunca omitas archivos por "parecer seguros"
- Prioriza datos criticos y endpoints publicos
- Incluye el archivo y linea exacta de cada hallazgo

Como funciona por dentro

Instalar Skills existentes

Usa el CLI npx skills para instalar skills de la comunidad:

# Cloudflare Workers, AI, KV, R2, D1
npx skills add https://github.com/cloudflare/skills

# AI models via Replicate
npx skills add replicate/skills

# UI/UX design patterns de Anthropic
npx skills add https://github.com/anthropics/skills --skill frontend-design

# Creador de skills (para hacer tus propios skills)
npx skills add https://github.com/anthropics/skills --skill skill-creator

Permisos de Skills

Puedes controlar que skills puede usar cada agente en opencode.json:

{
  "permission": {
    "skill": {
      "*": "allow",
      "internal-*": "deny",
      "experimental-*": "ask"
    }
  }
}

Buenas Practicas

Commands vs Skills vs Agents

Recursos

Resumenes de Libros

Estos resumenes fueron generados automaticamente a partir de PDFs usando la skill pdf-to-web. Haz clic en cada titulo para ver el resumen completo.