Guía de OpenCode Skills: 7 reglas para flujos reutilizables de IA

OpenCode skills son paquetes de instrucciones reutilizables para trabajo de programación repetido. Úsalas cuando quieres que OpenCode recuerde un procedimiento, una regla de dominio o una norma de revisión. No las uses como almacén de secretos ni como sustituto de agents o MCP. Una skill merece existir cuando la misma instrucción vuelve en muchos prompts. Si la nota es única, escríbela en el prompt; si es una preferencia permanente, documéntala en configuración o en el README.

Una skill merece existir cuando la misma instrucción vuelve en muchos prompts. Si la nota es única, escríbela en el prompt; si es una preferencia permanente, documéntala en configuración o en el README.

La prueba correcta es comparar una tarea pequeña con y sin la skill. Si reduce explicación repetida y mejora el diff, merece quedarse; si solo añade política vaga, conviene acortarla o eliminarla.

Las skills de proyecto son más fáciles de revisar porque viven junto al código. Una skill global puede afectar repositorios distintos, así que úsala solo para hábitos realmente universales.

Cuando una skill menciona un framework, un destino de despliegue, una voz editorial o una regla de cumplimiento, normalmente pertenece al proyecto y no al perfil global.

Una skill merece existir cuando la misma instrucción vuelve en muchos prompts. Si la nota es única, escríbela en el prompt; si es una preferencia permanente, documéntala en configuración o en el README.

Una skill guía el comportamiento; un command inicia una acción nombrada; un agent separa rol y contexto; MCP conecta herramientas externas. Mantener esa separación hace que el fallo sea diagnosticable.

Las skills de proyecto son más fáciles de revisar porque viven junto al código. Una skill global puede afectar repositorios distintos, así que úsala solo para hábitos realmente universales.

Escribe la skill como revisarías código: propósito, disparador, pasos obligatorios, límites y evidencia esperada. Si no puede probarse, casi siempre es demasiado amplia.

Una skill merece existir cuando la misma instrucción vuelve en muchos prompts. Si la nota es única, escríbela en el prompt; si es una preferencia permanente, documéntala en configuración o en el README.

Empieza con una plantilla mínima y sustituye los marcadores por comandos reales del repositorio. Una skill pequeña se revisa, se corrige y se abandona con menos coste.

---
name: repository-review
description: Use when reviewing code changes in this repository.
---

# Repository Review

1. Inspect the changed files and nearby tests before giving findings.
2. Prioritize bugs, regressions, security risks, and missing validation.
3. Run the documented test command when the touched area has one.
4. Report findings first with file and line references.
5. If no issue is found, say so and mention residual test risk.

Las skills de proyecto son más fáciles de revisar porque viven junto al código. Una skill global puede afectar repositorios distintos, así que úsala solo para hábitos realmente universales.

Los secretos viven en variables de entorno, autenticación del proveedor o un gestor de contraseñas. La skill debe explicar el manejo, no contener tokens.

Una skill merece existir cuando la misma instrucción vuelve en muchos prompts. Si la nota es única, escríbela en el prompt; si es una preferencia permanente, documéntala en configuración o en el README.

Si el resultado empeora, prueba la tarea con la skill completa, una versión corta y un prompt normal. La comparación revela si el problema es solapamiento o falta de precisión.

Antes de separar reglas de AGENTS.md en subagents, revisa la guía de OpenCode agents. guía de OpenCode agents.