Comandos personalizados

Dónde va

.opencode/commands/nombre.md      → proyecto
~/.config/opencode/commands/nombre.md  → global

Plantilla base

.opencode/commands/review.md

---
description: Revisa el diff actual
agent: build
---

template: |
Revisa los cambios actuales con `git diff` y señala:

1. Bugs potenciales
2. Problemas de legibilidad

Argumentos: $ARGUMENTS

A diferencia de Claude Code (donde el cuerpo entero del archivo es el prompt), OpenCode requiere el campo template: explícito con el texto que se manda al modelo — el resto del frontmatter es metadata.

O inline en opencode.json

opencode.json

{
  "command": {
    "review": {
      "template": "Revisa el diff actual: !`git diff`",
      "description": "Revisa el diff actual",
      "agent": "build"
    }
  }
}

Interpolación

$ARGUMENTS       → todo lo que sigue al comando
$1 $2 $3          → argumentos posicionales
!`comando`        → corre un shell command antes, inyecta el resultado
@archivo          → referencia un archivo

Misma sintaxis que Claude Code para esto — solo cambia dónde vive el prompt (template: explícito vs. cuerpo del archivo).

Resumen

Campo	Para qué
template	El prompt en sí (requerido)
agent	Qué agente ejecuta el comando
model	Override del modelo para este comando puntual
subtask	Fuerza que corra como subagente aunque el agente activo sea primario

Consideraciones

• Olvidar template: es el error más común migrando un comando desde Claude Code — sin ese campo, el comando no tiene prompt.