Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.
Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.
Pasos de configuración
Prepara una prueba acotada
Define una pregunta que puedas resolver con el dataset público del inicio rápido. Usa después una copia de prueba si necesitas datos propios.
Configura Spice
Sigue Spice, incluidos sus requisitos, configuración y comprobación actuales. Completa el inicio rápido en la misma carpeta de proyecto y comprueba la tabla y consulta del conjunto público antes de usar datos propios.
Configura Supabase Agent Skills
Sigue Supabase Agent Skills, incluidos sus requisitos, configuración y comprobación actuales. Carga la skill de PostgreSQL en el arnés y comprueba que una revisión de SQL aplica sus instrucciones y declara motor y supuestos.
Datos que pasan entre piezas
Los archivos siguientes son entregables de este caso preparados por el agente; no implican exportadores ni sincronización automática.
Pasa de Spice al agente esquema.md con tablas, columnas, motor y origen del conjunto de prueba; la skill de Supabase revisa únicamente criterios aplicables a ese motor. Devuelve consulta.sql y resultado.csv con fecha y consulta aprobada; sin esquema o resultado de referencia detén la ejecución, y no supongas una conexión MCP creada por la skill.
Monta el flujo
Paso 1
Instala Spice, inicia el runtime y añade el dataset desde una segunda terminal en la misma carpeta, como indica su guía. Comprueba las tablas y la consulta de ejemplo antes de conectar al agente.
Paso 2
Instala la skill de PostgreSQL y entrega al agente el esquema revisado. Pide una consulta con columnas explícitas y resultado acotado; usa sus recomendaciones solo cuando correspondan al motor real.
Paso 3
Revisa la consulta, ejecútala sobre el conjunto de prueba y conserva SQL, origen y fecha del resultado. Para una fuente propia sigue el conector oficial y verifica lectura restringida antes de repetir el proceso.
Comprobación
Compara una consulta con un resultado conocido. Confirma el esquema utilizado y comprueba por separado que el usuario de origen no dispone de escritura.
Si algo falla
Si el SQL falla, identifica primero el dialecto y las tablas visibles. Si no hay claves documentadas, devuelve relaciones como hipótesis y solicita el esquema correcto.
La configuración se consulta en las guías del hub enlazadas. Esta composición es una propuesta de WISD; no se ha ejecutado como prueba integral.
Lee y sigue las instrucciones publicadas de las piezas: Spice: /hub/spice-ai-sidecar/instrucciones.md; Supabase Agent Skills: /hub/supabase-agent-skills/instrucciones.md. Completa los requisitos, configuración y comprobación de cada pieza antes de usarla; comprueba su uso desde el cliente o arnés elegido, no solo su presencia en disco. Si falta un campo entre <>, una fuente obligatoria, acceso o una operación documentada, detén la etapa dependiente, informa qué falta y pídemelo; usa una alternativa manual solo cuando esté descrita y comprobada. No inventes datos ni des por superada una comprobación pendiente.
Para <pregunta>, prepara en Spice <dataset de prueba autorizado> siguiendo su guía. Comprueba esquema y ejemplo antes de conectar el agente. Usa Supabase Agent Skills para revisar SQL cuando el destino sea PostgreSQL. Propón columnas explícitas y resultado limitado; espera revisión antes de ejecutar. Contrasta con <resultado conocido> y guarda SQL, origen, fecha y resultado en <ruta>. No inventes relaciones ni conectes fuentes adicionales.
Pasa de Spice al agente esquema.md con tablas, columnas, motor y origen del conjunto de prueba; la skill de Supabase revisa únicamente criterios aplicables a ese motor. Devuelve consulta.sql y resultado.csv con fecha y consulta aprobada; sin esquema o resultado de referencia detén la ejecución, y no supongas una conexión MCP creada por la skill.
Qué es
Un flujo de exploración de datos para un agente con acceso a terminal. Primero compruebas qué tablas ve un runtime de consulta y después revisas las propuestas SQL contra un esquema conocido. La conexión de datos y las instrucciones de revisión son piezas separadas.
Para qué te sirve
Cuando quieres responder una pregunta sobre datos de prueba sin dar acceso general a una base real.
Cuando necesitas revisar supuestos de una consulta antes de trasladarla a PostgreSQL.
Cuando una respuesta cambia al unir tablas y debes comprobar las claves antes de aceptar el resultado.
Cómo funciona
Spice expone datasets mediante SQL y aporta un ejemplo público para ensayar. Supabase Agent Skills aporta criterios de PostgreSQL para revisar consultas cuando ese sea el motor de destino. El agente recibe el esquema autorizado y propone una consulta limitada; tú revisas el SQL antes de ejecutarlo.
Antes de empezar
La ruta binaria de Spice requiere curl y Bash en macOS, Linux o WSL; Windows usa WSL para el runtime desde v2.0. Las skills requieren Node.js ≥22.20.0 con npm/npx y un arnés compatible. Para fuentes propias prepara un conector documentado y permisos de lectura efectivos en el origen.
Límites y alternativas
Spice no garantiza que el dialecto de una consulta sea idéntico a PostgreSQL. Las skills no inspeccionan por sí solas tu base ni crean una conexión MCP. No deduzcas relaciones entre tablas solo por nombres de columnas: confirma claves en el esquema. Para una base aislada puede bastar su cliente SQL habitual.
