Skills operativas del homelab¶
Creado el 2026-09-13 para reutilizar conocimiento sin convertir observaciones históricas en estado actual. Fuentes versionadas en skills/; copias instaladas en ~/.codex/skills/.
| Skill | Uso |
|---|---|
| homelab-operations | Encontrar servicios existentes, documentos y automatismos; diagnóstico acotado y evidencia fechada. |
| homelab-trip-planner | App Japón: documentos, reservas, correo, PWA y Wallet; invariantes y rutas hacia documentación del repo. |
| homelab-add-service | Alta de productos: guía y comprobadores existentes. No duplicada por estas skills. |
Herramientas¶
Desde cualquier directorio:
python3 ~/.codex/skills/homelab-operations/scripts/homelab_context.py locate radarr
python3 ~/.codex/skills/homelab-operations/scripts/homelab_context.py status
python3 ~/.codex/skills/homelab-operations/scripts/homelab_context.py status trip-planner
python3 ~/.codex/skills/homelab-operations/scripts/homelab_context.py runtime trip-planner
locate lee exclusivamente el inventario local y nombres de documentos. Muestra fechas y marca explícitamente que no verifica estado vivo; limita cada categoría a 20 resultados y da totales. status lee el informe ya generado por contratos en VM208: cero auditorías duplicadas, cero activaciones Sablier. runtime lee tres campos de un contenedor exacto con SSH confiable y timeout; no obtiene variables de entorno ni prueba funcionalidad. No hace peticiones HTTP.
Salida JSON; status devuelve 0 para evidencia registrada reciente sin fallos ni pendientes, 1 para fallos registrados, 2 para datos obsoletos, faltantes o no verificados. Runtime 0 significa lectura correcta del estado, incluso detenido: no significa producto sano. Locate 0 significa fuentes legibles, incluso históricas/sin coincidencias. Errores SSH se clasifican sin volcar stderr privado. No hay reintentos automáticos.
Mantener las copias instaladas¶
Desde este repositorio:
Sin --apply solo compara (salida 1 si hay cambios). Con --apply copia únicamente estas dos skills, sin borrar archivos ni instalar tareas/servicios. No modifica homelab-add-service. Rechaza destinos symlink. No incorpora pycache.
Modificar la fuente versionada, ejecutar validadores de skill-creator y skills/homelab-operations/scripts/test_homelab_context.py, instalar y repetir comparación. La sesión siguiente descubre las skills instaladas; en una sesión ya abierta se puede indicar su SKILL.md directamente.
Validación de esta entrega¶
- Dos skills pasan quick_validate.py.
- Seis pruebas: evidencia antigua, cobertura pendiente, servicio ausente, clasificación de fallos, rechazo de nombres interpretables como comandos y exclusión de secretos del inventario.
- Lectura real locate trip-planner: inventario fechado septiembre 8 identificado como histórico.
- Lecturas reales status trip-planner y runtime trip-planner: informe sin fallos ni pendientes, contenedor running y cero reinicios. Observaciones puntuales, no garantía e2e.
- No se modificó infraestructura ni se despertaron servicios para estas pruebas.
La guía reduce las lecturas iniciales. Para reparar se sigue necesitando comprobar configuración activa, alcance y resultado funcional del producto; ninguna skill convierte una prueba pasada en garantía permanente.