@neurocode-ai/web 1.18.8

package/src/content/docs/es/server.mdx

@@ -0,0 +1,287 @@
+---
+title: Servidor
+description: Interactuar con el servidor opencode a través de HTTP.
+---
+
+import config from "../../../../config.mjs"
+export const typesUrl = `${config.github}/blob/dev/packages/sdk/js/src/gen/types.gen.ts`
+
+El comando `opencode serve` ejecuta un servidor HTTP sin cabeza que expone un punto final OpenAPI que un cliente opencode puede usar.
+
+---
+
+### Uso
+
+```bash
+opencode serve [--port <number>] [--hostname <string>] [--cors <origin>]
+```
+
+#### Opciones
+
+| Bandera         | Descripción                                           | Predeterminado   |
+| --------------- | ----------------------------------------------------- | ---------------- |
+| `--port`        | Puerto para escuchar                                  | `4096`           |
+| `--hostname`    | Nombre de host para escuchar                          | `127.0.0.1`      |
+| `--mdns`        | Habilitar el descubrimiento de mDNS                   | `false`          |
+| `--mdns-domain` | Nombre de dominio personalizado para el servicio mDNS | `opencode.local` |
+| `--cors`        | Orígenes de navegador adicionales para permitir       | `[]`             |
+
+`--cors` se puede pasar varias veces:
+
+```bash
+opencode serve --cors http://localhost:5173 --cors https://app.example.com
+```
+
+---
+
+### Autenticación
+
+Configure `OPENCODE_SERVER_PASSWORD` para proteger el servidor con autenticación básica HTTP. El nombre de usuario predeterminado es `opencode`, o configure `OPENCODE_SERVER_USERNAME` para anularlo. Esto se aplica tanto a `opencode serve` como a `opencode web`.
+
+```bash
+OPENCODE_SERVER_PASSWORD=your-password opencode serve
+```
+
+---
+
+### Cómo funciona
+
+Cuando ejecuta `opencode`, inicia un TUI y un servidor. Donde el TUI es el
+Cliente que habla con el servidor. El servidor expone una especificación OpenAPI 3.1
+punto final. Este punto final también se utiliza para generar un [SDK](/docs/sdk).
+
+:::tip
+Utilice el servidor opencode para interactuar con opencode mediante programación.
+:::
+
+Esta arquitectura permite que opencode admita múltiples clientes y le permite interactuar con opencode mediante programación.
+
+Puede ejecutar `opencode serve` para iniciar un servidor independiente. Si tienes el
+opencode TUI ejecutándose, `opencode serve` iniciará un nuevo servidor.
+
+---
+
+#### Conectarse a un servidor existente
+
+Cuando inicia el TUI, asigna aleatoriamente un puerto y un nombre de host. En su lugar, puede pasar `--hostname` y `--port` [banderas](/docs/cli). Luego use esto para conectarse a su servidor.
+
+El punto final [`/tui`](#tui) se puede utilizar para conducir el TUI a través del servidor. Por ejemplo, puede completar previamente o ejecutar un mensaje. Esta configuración es utilizada por los complementos OpenCode [IDE](/docs/ide).
+
+---
+
+## Especificaciones
+
+El servidor publica una especificación OpenAPI 3.1 que se puede ver en:
+
+```
+http://<hostname>:<port>/doc
+```
+
+Por ejemplo, `http://localhost:4096/doc`. Utilice la especificación para generar clientes o inspeccionar tipos de solicitudes y respuestas. O verlo en un explorador Swagger.
+
+---
+
+## API
+
+El servidor opencode expone las siguientes API.
+
+---
+
+### Global
+
+| Método | Ruta             | Descripción                                 | Respuesta                            |
+| ------ | ---------------- | ------------------------------------------- | ------------------------------------ |
+| `GET`  | `/global/health` | Obtener el estado y la versión del servidor | `{ healthy: true, version: string }` |
+| `GET`  | `/global/event`  | Obtenga eventos globales (transmisión SSE)  | Flujo de eventos                     |
+
+---
+
+### Proyecto
+
+| Método | Ruta               | Descripción                | Respuesta                                     |
+| ------ | ------------------ | -------------------------- | --------------------------------------------- |
+| `GET`  | `/project`         | Listar todos los proyectos | <a href={typesUrl}><code>Project[]</code></a> |
+| `GET`  | `/project/current` | Obtener el proyecto actual | <a href={typesUrl}><code>Project</code></a>   |
+
+---
+
+### Ruta y VCS
+
+| Método | Ruta    | Descripción                                        | Respuesta                                   |
+| ------ | ------- | -------------------------------------------------- | ------------------------------------------- |
+| `GET`  | `/path` | Obtener la ruta actual                             | <a href={typesUrl}><code>Path</code></a>    |
+| `GET`  | `/vcs`  | Obtenga información de VCS para el proyecto actual | <a href={typesUrl}><code>VcsInfo</code></a> |
+
+---
+
+### Instancia
+
+| Método | Ruta                | Descripción                  | Respuesta |
+| ------ | ------------------- | ---------------------------- | --------- |
+| `POST` | `/instance/dispose` | Eliminar la instancia actual | `boolean` |
+
+---
+
+### Configuración
+
+| Método  | Ruta                | Descripción                                    | Respuesta                                                                                 |
+| ------- | ------------------- | ---------------------------------------------- | ----------------------------------------------------------------------------------------- |
+| `GET`   | `/config`           | Obtener información de configuración           | <a href={typesUrl}><code>Config</code></a>                                                |
+| `PATCH` | `/config`           | Actualizar configuración                       | <a href={typesUrl}><code>Config</code></a>                                                |
+| `GET`   | `/config/providers` | Lista de proveedores y modelos predeterminados | `{ providers: `<a href={typesUrl}>Proveedor[]</a>`, default: { [key: string]: string } }` |
+
+---
+
+### Proveedor
+
+| Método | Ruta                             | Descripción                                              | Respuesta                                                                            |
+| ------ | -------------------------------- | -------------------------------------------------------- | ------------------------------------------------------------------------------------ |
+| `GET`  | `/provider`                      | Listar todos los proveedores                             | `{ all: `<a href={typesUrl}>Proveedor[]</a>`, default: {...}, connected: string[] }` |
+| `GET`  | `/provider/auth`                 | Obtener métodos de autenticación de proveedores          | `{ [providerID: string]: `<a href={typesUrl}>ProviderAuthMethod[]</a>` }`            |
+| `POST` | `/provider/{id}/oauth/authorize` | Autorizar a un proveedor usando OAuth                    | <a href={typesUrl}><code>ProviderAuthAuthorization</code></a>                        |
+| `POST` | `/provider/{id}/oauth/callback`  | Manejar la devolución de llamada OAuth para un proveedor | `boolean`                                                                            |
+
+---
+
+### Sesiones
+
+| Método   | Ruta                                     | Descripción                                            | Notas                                                                                 |
+| -------- | ---------------------------------------- | ------------------------------------------------------ | ------------------------------------------------------------------------------------- |
+| `GET`    | `/session`                               | Listar todas las sesiones                              | Devuelve <a href={typesUrl}><code>Session[]</code></a>                                |
+| `POST`   | `/session`                               | Crear una nueva sesión                                 | cuerpo: `{ parentID?, title? }`, devuelve <a href={typesUrl}><code>Session</code></a> |
+| `GET`    | `/session/status`                        | Obtener el estado de la sesión para todas las sesiones | Devuelve `{ [sessionID: string]: `<a href={typesUrl}>SessionStatus</a>` }`            |
+| `GET`    | `/session/:id`                           | Obtener detalles de la sesión                          | Devuelve <a href={typesUrl}><code>Session</code></a>                                  |
+| `DELETE` | `/session/:id`                           | Eliminar una sesión y todos sus datos                  | Devuelve `boolean`                                                                    |
+| `PATCH`  | `/session/:id`                           | Actualizar propiedades de sesión                       | cuerpo: `{ title? }`, devuelve <a href={typesUrl}><code>Session</code></a>            |
+| `GET`    | `/session/:id/children`                  | Obtener las sesiones secundarias de una sesión         | Devuelve <a href={typesUrl}><code>Session[]</code></a>                                |
+| `GET`    | `/session/:id/todo`                      | Obtener la lista de tareas pendientes para una sesión  | Devuelve <a href={typesUrl}><code>Todo[]</code></a>                                   |
+| `POST`   | `/session/:id/init`                      | Analizar aplicación y crear `AGENTS.md`                | cuerpo: `{ messageID, providerID, modelID }`, devuelve `boolean`                      |
+| `POST`   | `/session/:id/fork`                      | Bifurca una sesión existente en un mensaje             | cuerpo: `{ messageID? }`, devuelve <a href={typesUrl}><code>Session</code></a>        |
+| `POST`   | `/session/:id/abort`                     | Cancelar una sesión en ejecución                       | Devuelve `boolean`                                                                    |
+| `POST`   | `/session/:id/share`                     | Compartir una sesión                                   | Devuelve <a href={typesUrl}><code>Session</code></a>                                  |
+| `DELETE` | `/session/:id/share`                     | Dejar de compartir una sesión                          | Devuelve <a href={typesUrl}><code>Session</code></a>                                  |
+| `GET`    | `/session/:id/diff`                      | Obtenga la diferencia para esta sesión                 | consulta: `messageID?`, devuelve <a href={typesUrl}><code>FileDiff[]</code></a>       |
+| `POST`   | `/session/:id/summarize`                 | Resumir la sesión                                      | cuerpo: `{ providerID, modelID }`, devuelve `boolean`                                 |
+| `POST`   | `/session/:id/revert`                    | Revertir un mensaje                                    | cuerpo: `{ messageID, partID? }`, devuelve `boolean`                                  |
+| `POST`   | `/session/:id/unrevert`                  | Restaurar todos los mensajes revertidos                | Devuelve `boolean`                                                                    |
+| `POST`   | `/session/:id/permissions/:permissionID` | Responder a una solicitud de permiso                   | cuerpo: `{ response, remember? }`, devuelve `boolean`                                 |
+
+---
+
+### Mensajes
+
+| Método | Ruta                              | Descripción                                         | Notas                                                                                                                                                                     |
+| ------ | --------------------------------- | --------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `GET`  | `/session/:id/message`            | Listar mensajes en una sesión                       | consulta: `limit?`, devuelve `{ info: `<a href={typesUrl}>Mensaje</a>`, parts: `<a href={typesUrl}>Parte[]</a>`}[]`                                                       |
+| `POST` | `/session/:id/message`            | Envía un mensaje y espera respuesta                 | cuerpo: `{ messageID?, model?, agent?, noReply?, system?, tools?, parts }`, devuelve `{ info: `<a href={typesUrl}>Mensaje</a>`, parts: `<a href={typesUrl}>Parte[]</a>`}` |
+| `GET`  | `/session/:id/message/:messageID` | Obtener detalles del mensaje                        | Devuelve `{ info: `<a href={typesUrl}>Mensaje</a>`, parts: `<a href={typesUrl}>Parte[]</a>`}`                                                                             |
+| `POST` | `/session/:id/prompt_async`       | Enviar un mensaje de forma asincrónica (sin espera) | cuerpo: igual que `/session/:id/message`, devuelve `204 No Content`                                                                                                       |
+| `POST` | `/session/:id/command`            | Ejecutar un comando de barra diagonal               | cuerpo: `{ messageID?, agent?, model?, command, arguments }`, devuelve `{ info: `<a href={typesUrl}>Mensaje</a>`, parts: `<a href={typesUrl}>Parte[]</a>`}`               |
+| `POST` | `/session/:id/shell`              | Ejecute un comando de shell                         | cuerpo: `{ agent, model?, command }`, devuelve `{ info: `<a href={typesUrl}>Mensaje</a>`, parts: `<a href={typesUrl}>Parte[]</a>`}`                                       |
+
+---
+
+### Comandos
+
+| Método | Ruta       | Descripción               | Respuesta                                     |
+| ------ | ---------- | ------------------------- | --------------------------------------------- |
+| `GET`  | `/command` | Listar todos los comandos | <a href={typesUrl}><code>Command[]</code></a> |
+
+---
+
+### Archivos
+
+| Método | Ruta                     | Descripción                                  | Respuesta                                                                                          |
+| ------ | ------------------------ | -------------------------------------------- | -------------------------------------------------------------------------------------------------- |
+| `GET`  | `/find?pattern=<pat>`    | Buscar texto en archivos                     | Matriz de objetos coincidentes con `path`, `lines`, `line_number`, `absolute_offset`, `submatches` |
+| `GET`  | `/find/file?query=<q>`   | Buscar archivos y directorios por nombre     | `string[]` (caminos)                                                                               |
+| `GET`  | `/find/symbol?query=<q>` | Buscar símbolos del espacio de trabajo       | <a href={typesUrl}><code>Symbol[]</code></a>                                                       |
+| `GET`  | `/file?path=<path>`      | Listar archivos y directorios                | <a href={typesUrl}><code>FileNode[]</code></a>                                                     |
+| `GET`  | `/file/content?path=<p>` | Leer un archivo                              | <a href={typesUrl}><code>FileContent</code></a>                                                    |
+| `GET`  | `/file/status`           | Obtener el estado de los archivos rastreados | <a href={typesUrl}><code>File[]</code></a>                                                         |
+
+#### Parámetros de consulta de /find/file
+
+- `query` (obligatorio) — cadena de búsqueda (coincidencia aproximada)
+- `type` (opcional): limita los resultados a `"file"` o `"directory"`
+- `directory` (opcional): anula la raíz del proyecto para la búsqueda.
+- `limit` (opcional) — resultados máximos (1–200)
+- `dirs` (opcional): indicador heredado (`"false"` devuelve solo archivos)
+
+---
+
+### Herramientas (experimentales)
+
+| Método | Ruta                                        | Descripción                                          | Respuesta                                    |
+| ------ | ------------------------------------------- | ---------------------------------------------------- | -------------------------------------------- |
+| `GET`  | `/experimental/tool/ids`                    | Listar todos los ID de herramientas                  | <a href={typesUrl}><code>ToolIDs</code></a>  |
+| `GET`  | `/experimental/tool?provider=<p>&model=<m>` | Listar herramientas con esquemas JSON para un modelo | <a href={typesUrl}><code>ToolList</code></a> |
+
+---
+
+### LSP, formateadores y MCP
+
+| Método | Ruta         | Descripción                           | Respuesta                                                 |
+| ------ | ------------ | ------------------------------------- | --------------------------------------------------------- |
+| `GET`  | `/lsp`       | Obtener el estado del servidor LSP    | <a href={typesUrl}><code>LSPStatus[]</code></a>           |
+| `GET`  | `/formatter` | Obtener estado del formateador        | <a href={typesUrl}><code>FormatterStatus[]</code></a>     |
+| `GET`  | `/mcp`       | Obtener el estado del servidor MCP    | `{ [name: string]: `<a href={typesUrl}>MCPStatus</a>` }`  |
+| `POST` | `/mcp`       | Agregue el servidor MCP dinámicamente | cuerpo: `{ name, config }`, devuelve MCP objeto de estado |
+
+---
+
+### Agentes
+
+| Método | Ruta     | Descripción                          | Respuesta                                   |
+| ------ | -------- | ------------------------------------ | ------------------------------------------- |
+| `GET`  | `/agent` | Listar todos los agentes disponibles | <a href={typesUrl}><code>Agent[]</code></a> |
+
+---
+
+### Registro
+
+| Método | Ruta   | Descripción                                                                 | Respuesta |
+| ------ | ------ | --------------------------------------------------------------------------- | --------- |
+| `POST` | `/log` | Escribir entrada de registro. Cuerpo: `{ service, level, message, extra? }` | `boolean` |
+
+---
+
+### TUI
+
+| Método | Ruta                    | Descripción                                       | Respuesta                      |
+| ------ | ----------------------- | ------------------------------------------------- | ------------------------------ |
+| `POST` | `/tui/append-prompt`    | Agregar texto al mensaje                          | `boolean`                      |
+| `POST` | `/tui/open-help`        | Abra el cuadro de diálogo de ayuda                | `boolean`                      |
+| `POST` | `/tui/open-sessions`    | Abrir el selector de sesiones                     | `boolean`                      |
+| `POST` | `/tui/open-themes`      | Abra el selector de temas                         | `boolean`                      |
+| `POST` | `/tui/open-models`      | Abrir el selector de modelo                       | `boolean`                      |
+| `POST` | `/tui/submit-prompt`    | Enviar el mensaje actual                          | `boolean`                      |
+| `POST` | `/tui/clear-prompt`     | Borrar el mensaje                                 | `boolean`                      |
+| `POST` | `/tui/execute-command`  | Ejecutar un comando (`{ command }`)               | `boolean`                      |
+| `POST` | `/tui/show-toast`       | Mostrar brindis (`{ title?, message, variant }`)  | `boolean`                      |
+| `GET`  | `/tui/control/next`     | Espere la próxima solicitud de control            | Objeto de solicitud de control |
+| `POST` | `/tui/control/response` | Responder a una solicitud de control (`{ body }`) | `boolean`                      |
+
+---
+
+### Autenticación
+
+| Método | Ruta        | Descripción                                                                                     | Respuesta |
+| ------ | ----------- | ----------------------------------------------------------------------------------------------- | --------- |
+| `PUT`  | `/auth/:id` | Establecer credenciales de autenticación. El cuerpo debe coincidir con el esquema del proveedor | `boolean` |
+
+---
+
+### Eventos
+
+| Método | Ruta     | Descripción                                                                                                   | Respuesta                                       |
+| ------ | -------- | ------------------------------------------------------------------------------------------------------------- | ----------------------------------------------- |
+| `GET`  | `/event` | Transmisión de eventos enviados por el servidor. El primer evento es `server.connected`, luego eventos de bus | Transmisión de eventos enviados por el servidor |
+
+---
+
+### Documentación
+
+| Método | Ruta   | Descripción                | Respuesta                              |
+| ------ | ------ | -------------------------- | -------------------------------------- |
+| `GET`  | `/doc` | Especificación OpenAPI 3.1 | Página HTML con especificación OpenAPI |

package/src/content/docs/es/share.mdx

@@ -0,0 +1,128 @@
+---
+title: Compartir
+description: Comparte tus conversaciones OpenCode.
+---
+
+La función para compartir de OpenCode te permite crear enlaces públicos a tus conversaciones de OpenCode, para que puedas colaborar con compañeros de equipo u obtener ayuda de otros.
+
+:::note
+Las conversaciones compartidas son de acceso público para cualquier persona que tenga el enlace.
+:::
+
+---
+
+## Cómo funciona
+
+Cuando compartes una conversación, OpenCode:
+
+1. Crea una URL pública única para su sesión.
+2. Sincroniza tu historial de conversaciones con nuestros servidores
+3. Hace que la conversación sea accesible a través del enlace para compartir: `opncd.ai/s/<share-id>`
+
+---
+
+## Uso compartido
+
+OpenCode admite tres modos de compartir que controlan cómo se comparten las conversaciones:
+
+---
+
+### Manual (predeterminado)
+
+De forma predeterminada, OpenCode usa el modo de compartir manual. Las sesiones no se comparten automáticamente, pero puedes compartirlas manualmente usando el comando `/share`:
+
+```
+/share
+```
+
+Esto generará una URL única que se copiará en su portapapeles.
+
+Para configurar explícitamente el modo manual en su [archivo de configuración](/docs/config):
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "share": "manual"
+}
+```
+
+---
+
+### Compartir automáticamente
+
+Puede habilitar el uso compartido automático para todas las conversaciones nuevas configurando la opción `share` en `"auto"` en su [archivo de configuración](/docs/config):
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "share": "auto"
+}
+```
+
+Con el uso compartido automático habilitado, cada nueva conversación se compartirá automáticamente y se generará un enlace.
+
+---
+
+### Desactivado
+
+Puede desactivar el uso compartido por completo configurando la opción `share` en `"disabled"` en su [archivo de configuración](/docs/config):
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "share": "disabled"
+}
+```
+
+Para aplicar esto en todo su equipo para un proyecto determinado, agréguelo al `opencode.json` en su proyecto y regístrelo en Git.
+
+---
+
+## Dejar de compartir
+
+Para dejar de compartir una conversación y eliminarla del acceso público:
+
+```
+/unshare
+```
+
+Esto eliminará el enlace para compartir y eliminará los datos relacionados con la conversación.
+
+---
+
+## Privacidad
+
+Hay algunas cosas a tener en cuenta al compartir una conversación.
+
+---
+
+### Retención de datos
+
+Las conversaciones compartidas permanecen accesibles hasta que las dejes de compartir explícitamente. Este
+incluye:
+
+- Historial de conversaciones completo
+- Todos los mensajes y respuestas.
+- Metadatos de la sesión
+
+---
+
+### Recomendaciones
+
+- Comparta únicamente conversaciones que no contengan información confidencial.
+- Revisar el contenido de la conversación antes de compartir.
+- Dejar de compartir conversaciones cuando se complete la colaboración.
+- Evite compartir conversaciones con código propietario o datos confidenciales.
+- Para proyectos confidenciales, deshabilite el uso compartido por completo.
+
+---
+
+## Para empresas
+
+Para implementaciones empresariales, la función de compartir puede ser:
+
+- **Desactivado** completamente por motivos de seguridad.
+- **Restringido** solo a usuarios autenticados a través de SSO
+- **Autohospedado** en tu propia infraestructura
+
+[Obtenga más información](/docs/enterprise) sobre el uso de opencode en su organización.

package/src/content/docs/es/skills.mdx

@@ -0,0 +1,222 @@
+---
+title: "Habilidades del agente"
+description: "Defina el comportamiento reutilizable mediante definiciones de SKILL.md"
+---
+
+Las habilidades del agente permiten a OpenCode descubrir instrucciones reutilizables de su repositorio o directorio de inicio.
+Las habilidades se cargan bajo demanda a través de la herramienta nativa `skill`: los agentes ven las habilidades disponibles y pueden cargar el contenido completo cuando sea necesario.
+
+---
+
+## Colocar archivos
+
+Cree una carpeta por nombre de habilidad y coloque un `SKILL.md` dentro de ella.
+OpenCode busca estas ubicaciones:
+
+- Configuración del proyecto: `.opencode/skills/<name>/SKILL.md`
+- Configuración global: `~/.config/opencode/skills/<name>/SKILL.md`
+- Compatible con Proyecto Claude: `.claude/skills/<name>/SKILL.md`
+- Compatible con Claude global: `~/.claude/skills/<name>/SKILL.md`
+- Compatible con agente de proyecto: `.agents/skills/<name>/SKILL.md`
+- Compatible con agentes globales: `~/.agents/skills/<name>/SKILL.md`
+
+---
+
+## Entender el descubrimiento
+
+Para las rutas locales del proyecto, OpenCode sube desde su directorio de trabajo actual hasta llegar al árbol de trabajo de git.
+Carga cualquier `skills/*/SKILL.md` coincidente en `.opencode/` y cualquier `.claude/skills/*/SKILL.md` o `.agents/skills/*/SKILL.md` coincidente a lo largo del camino.
+
+Las definiciones globales también se cargan desde `~/.config/opencode/skills/*/SKILL.md`, `~/.claude/skills/*/SKILL.md` y `~/.agents/skills/*/SKILL.md`.
+
+---
+
+## Escribir la introducción
+
+Cada `SKILL.md` debe comenzar con el frontmatter de YAML.
+Sólo se reconocen estos campos:
+
+- `name` (obligatorio)
+- `description` (obligatorio)
+- `license` (opcional)
+- `compatibility` (opcional)
+- `metadata` (opcional, mapa de cadena a cadena)
+
+Los campos desconocidos se ignoran.
+
+---
+
+## Validar nombres
+
+`name` debe:
+
+- Tener entre 1 y 64 caracteres.
+- Ser alfanuméricos en minúsculas con separadores de guión simple
+- No comienza ni termina con `-`
+- No contener `--` consecutivos
+- Coincide con el nombre del directorio que contiene `SKILL.md`
+
+expresión regular equivalente:
+
+```text
+^[a-z0-9]+(-[a-z0-9]+)*$
+```
+
+---
+
+## Seguir las reglas de longitud
+
+`description` debe tener entre 1 y 1024 caracteres.
+Manténgalo lo suficientemente específico para que el agente elija correctamente.
+
+---
+
+## Usar un ejemplo
+
+Crea `.opencode/skills/git-release/SKILL.md` así:
+
+```markdown
+---
+name: git-release
+description: Create consistent releases and changelogs
+license: MIT
+compatibility: opencode
+metadata:
+  audience: maintainers
+  workflow: github
+---
+
+## What I do
+
+- Draft release notes from merged PRs
+- Propose a version bump
+- Provide a copy-pasteable `gh release create` command
+
+## When to use me
+
+Use this when you are preparing a tagged release.
+Ask clarifying questions if the target versioning scheme is unclear.
+```
+
+---
+
+## Reconocer la descripción de la herramienta
+
+OpenCode enumera las habilidades disponibles en la descripción de la herramienta `skill`.
+Cada entrada incluye el nombre y la descripción de la habilidad:
+
+```xml
+<available_skills>
+  <skill>
+    <name>git-release</name>
+    <description>Create consistent releases and changelogs</description>
+  </skill>
+</available_skills>
+```
+
+El agente carga una habilidad llamando a la herramienta:
+
+```
+skill({ name: "git-release" })
+```
+
+---
+
+## Configurar permisos
+
+Controle a qué agentes de habilidades pueden acceder utilizando permisos basados ​​en patrones en `opencode.json`:
+
+```json
+{
+  "permission": {
+    "skill": {
+      "*": "allow",
+      "pr-review": "allow",
+      "internal-*": "deny",
+      "experimental-*": "ask"
+    }
+  }
+}
+```
+
+| Permiso | Comportamiento                                    |
+| ------- | ------------------------------------------------- |
+| `allow` | La habilidad se carga inmediatamente              |
+| `deny`  | Habilidad oculta al agente, acceso rechazado      |
+| `ask`   | Se solicita al usuario aprobación antes de cargar |
+
+Los patrones admiten comodines: `internal-*` coincide con `internal-docs`, `internal-tools`, etc.
+
+---
+
+## Anulación por agente
+
+Otorgue a agentes específicos permisos diferentes a los predeterminados globales.
+
+**Para agentes personalizados** (en el frente del agente):
+
+```yaml
+---
+permission:
+  skill:
+    "documents-*": "allow"
+---
+```
+
+**Para agentes integrados** (en `opencode.json`):
+
+```json
+{
+  "agent": {
+    "plan": {
+      "permission": {
+        "skill": {
+          "internal-*": "allow"
+        }
+      }
+    }
+  }
+}
+```
+
+---
+
+## Deshabilitar la herramienta de habilidades
+
+Deshabilite completamente las habilidades para los agentes que no deberían usarlas:
+
+**Para agentes personalizados**:
+
+```yaml
+---
+tools:
+  skill: false
+---
+```
+
+**Para agentes integrados**:
+
+```json
+{
+  "agent": {
+    "plan": {
+      "tools": {
+        "skill": false
+      }
+    }
+  }
+}
+```
+
+Cuando está deshabilitada, la sección `<available_skills>` se omite por completo.
+
+---
+
+## Solucionar problemas de carga
+
+Si una habilidad no aparece:
+
+1. Verifique que `SKILL.md` esté escrito en mayúsculas.
+2. Verifique que el frontmatter incluya `name` y `description`
+3. Asegúrese de que los nombres de las habilidades sean únicos en todas las ubicaciones
+4. Verifique los permisos: las habilidades con `deny` están ocultas para los agentes