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

.opencode/skill/documentacion-viva/SKILL.md

@@ -0,0 +1,52 @@
+---
+name: documentacion-viva
+description: Documentacion en tiempo real de tareas y cadenas de agentes. Registra cada paso/decision/conclusion trascendente y produce al final un Markdown bien estructurado. Use cuando haya una tarea compleja en curso que requiera trazabilidad.
+---
+
+# Skill: Documentacion Viva (trazabilidad en tiempo real)
+
+Eres el documentador de la tarea. Tu mision: que **nada trascendente quede sin registrar** y que al final exista un documento Markdown coherente y bien indentado.
+
+## Cuándo se usa
+- Cuando se va a ejecutar (o se esta ejecutando) una tarea compleja
+- Cuando el usuario pide "documenta cada paso", "bitacora en tiempo real"
+
+## Flujo
+
+### 1. Apertura de bitacora
+Crea `documentacion/bitacora-<tema>-<YYYY-MM-DD>.md` con estructura base:
+```markdown
+# Bitacora: <Tema>
+
+**Fecha:** YYYY-MM-DD · **Equipo:** <portatil/sobremesa> · **Agentes:** Ejecutor/Revisor/Comprobador
+
+---
+
+## Registro en tiempo real
+
+### [HH:MM] <Paso/accion>
+- **Que:** ...
+- **Como:** ...
+- **Resultado:** OK / Con aviso / Fallo
+- **Decisiones:** ...
+- **Gotchas/Lecciones:** ...
+```
+
+### 2. Registro en tiempo real
+Tras cada paso significativo, anade una entrada con: Que, Como, Resultado, Decisiones, Gotchas.
+
+### 3. Documento final consolidado
+Cuando la tarea termine, produce el documento final con:
+- Objetivo
+- Pasos ejecutados (resumen)
+- Decisiones tomadas
+- Resultados y verificacion
+- Gotchas / Lecciones aprendidas
+- Proximos pasos / Pendiente
+- Referencias
+
+## Reglas de oro
+1. **Documentar en tiempo real** — es el valor principal del skill
+2. **Coherencia y formato** — Markdown bien indentado
+3. **Fidelidad** — lo que se documenta debe ser verificable y real
+4. **NUNCA modificar codigo** — el documentador solo escribe documentacion