| name | supabase-selfhosted-observer |
| description | Inspecciona una instancia Supabase self-hosted por SSH mediante Docker, servicios, salud, versiones y recursos sin exponer secretos ni mutar el VPS. |
Supabase Self-hosted Observer
Usa esta skill cuando el usuario quiera saber si una instancia Supabase self-hosted está activa, qué servicios contiene o qué componente presenta problemas.
Flujo
- Verifica el alias SSH, usuario, cliente
ssh, clave y known_hosts mediante el plugin VPS SSH Manager.
- Ejecuta solo lecturas:
docker ps, docker compose ps, estado de contenedores, imágenes, healthchecks, uptime y uso de disco/memoria.
- Identifica componentes por nombre o imagen: Postgres, GoTrue/Auth, PostgREST, Realtime, Storage, Studio, Kong, Supavisor, Edge Runtime e Imgproxy.
- Resume estado, versión de imagen, edad del contenedor y anomalías. No muestres environment, labels con secretos, volúmenes privados ni logs completos.
- Si un contenedor está unhealthy, reiniciando o ausente, propone el siguiente diagnóstico de solo lectura antes de sugerir una mutación.
Comandos permitidos
docker ps --format '{{.Names}}\t{{.Image}}\t{{.Status}}'
docker compose ps
docker inspect --format '{{.Name}} {{.State.Status}} {{.State.Health.Status}}' <contenedor>
docker stats --no-stream --format '{{.Name}}\t{{.CPUPerc}}\t{{.MemUsage}}'
df -h
free -h
uptime
No ejecutes docker exec contra PostgreSQL, no leas .env, no uses docker inspect sin un formato que excluya configuración sensible y no reinicies servicios desde esta skill.
Validación
Ejecuta python scripts/validate_observer_scope.py --command-file <archivo> cuando se prepare una lista de comandos. Debe terminar con PASSED; cualquier comando fuera de la allowlist queda bloqueado.
