03-sep: [videoclub] Buscador interactivo + agentes/skills OpenCode + aviso por voz

.opencode/skill/videoclub-buscador/SKILL.md

@@ -0,0 +1,73 @@
+---
+name: videoclub-buscador
+description: Buscador interactivo de peliculas y series via Torrentio/RealDebrid con descarga a NAS Synology. Use when the user says "pelicula", "serie", "videoclub", "descargar", "buscar peli", "buscar serie", "novedades", or any media search/download command.
+---
+
+# Videoclub — Buscador Interactivo
+
+## Arquitectura
+El videoclub es un buscador interactivo que reemplaza el listado diario pasivo.
+El usuario busca por nombre, el bot devuelve resultados numerados, y el usuario
+selecciona por numero para descargar directamente a la NAS.
+
+## Flujo de usuario
+```
+/pelicula <nombre>     → Lista peliculas numeradas con enlaces
+/serie <nombre>        → Lista serie con temporadas/capitulos numerados
+/descargar <numero>    → Descarga el item seleccionado a la NAS
+/novedades             → Lista novedades del catalogo
+```
+
+## API de Torrentio
+- Catalogo: `https://torrentio.strem.fun/<config>/catalog/other/torrentio-realdebrid.json`
+- Config incluye token RealDebrid: `language=spanish|realdebrid=<token>`
+- Cada item del catalogo tiene: `id`, `name` (nombre del fichero torrent)
+- Los enlaces directos de descarga se obtienen de la API de RealDebrid:
+  `GET https://api.real-debrid.com/rest/1.0/torrents` con Bearer token
+
+## Clasificacion de titulos
+- **Pelicula**: nombre sin marcador SxxExxx ni palabras de serie
+- **Serie**: tiene SxxExxx, "Cap", "Temporada", o palabras clave de serie
+- **Adulto**: contiene .XXX, brazzers, spankbang, etc. → NUNCA se lista
+
+## Descarga a NAS
+- Usar `nas_dl.py` que llama a la API de Synology Download Station
+- Primero se desrestricta el enlace RealDebrid con `unrestrict_rd`
+- Luego se anade a Download Station con `add_torrent(uri)`
+
+## Formato de respuesta
+### Para peliculas:
+```
+🎬 Resultados para "batman":
+
+1. Batman Begins (2005) — 1080p, castellano
+2. The Dark Knight (2008) — 4K, castellano
+3. Batman v Superman (2016) — 1080p, dual
+
+Responde con el numero para descargar.
+```
+
+### Para series:
+```
+📺 Breaking Bad — 5 temporadas encontradas:
+
+Temporada 1:
+  1. S01E01 — Pilot
+  2. S01E02 — Cat's in the Bag
+  ...
+
+Temporada 2:
+  ...
+Responde con el numero de episodio para descargar.
+```
+
+## Scripts
+- `videoclub/videoclub.py` — catalogo diario + diff novedades
+- `videoclub/config.py` — token Torrentio + config
+- `vigilancia/nas_dl.py` — descarga NAS via Download Station API
+- `vigilancia/pelis.py` — logica de clasificacion y formateo
+
+## Configuracion (.env)
+- `TORRENTIO_RD_TOKEN` — token RealDebrid
+- `TORRENTIO_CONFIG` — configuracion Torrentio (default: language=spanish)
+- `NAS_HOST`, `NAS_PORT`, `NAS_USER`, `NAS_PASS` — credenciales NAS