Skills Agentes

Infra Postgres

Configura y gestiona Postgres con clickhousectl: Postgres local con Docker para desarrollo, o servicios Postgres gestionados en ClickHouse Cloud (conexiones, TLS, réplicas, failover, restauración).

Oficial
Estrellas
536

en todo el repo

Actividad
56

0–100, la ruta de este skill

Actualizado
hace 2 meses

último commit aquí

Commits
1

últimos 90 días

Contexto
664 tok

125 tok en reposo

Paquete
5 archivos

12 KB

Instalar

Funciona con cualquier agente que lea SKILL.md

npx -y skills add ClickHouse/agent-skills --skill infra-postgres --agent claude-code

Se instala solo en este repositorio.

Este skill makes network requests.

Qué hace

  • Configura y gestiona Postgres con la CLI clickhousectl, tanto local (Docker) como en ClickHouse Cloud
  • Crea instancias locales de Postgres con Docker para desarrollo y pruebas
  • Crea y opera servicios Postgres gestionados en ClickHouse Cloud: conexiones, TLS, réplicas de lectura, failover, restauración a un punto en el tiempo

Úsalo cuando

  • El usuario quiere una base de datos Postgres/PostgreSQL para su aplicación
  • Necesita un entorno de desarrollo local de Postgres o acceso psql
  • Quiere una Postgres gestionada/de producción en ClickHouse Cloud
  • Menciona pasar de un Postgres local a producción

No lo uses cuando

  • Para replicar datos de Postgres hacia ClickHouse con fines analíticos, usar ClickPipes en su lugar
  • Para ClickHouse en sí (local o Cloud), usar el skill infra-clickhouse

Qué lo activa

Di cualquiera de estas frases y el agente debería cargar este skill.

  • “Configúrame un Postgres local con Docker para desarrollo”
  • “Necesito llevar mi Postgres local a producción en ClickHouse Cloud”
  • “Crea un servicio Postgres gestionado con réplicas de lectura”
  • “Dame acceso psql a mi base de datos local”

SKILL.md

En inglés

Postgres with clickhousectl

clickhousectl manages Postgres in two environments:

  • Local — named, Docker-backed Postgres instances on the user's machine, for development.
  • Cloud — managed Postgres services in ClickHouse Cloud (beta), for production: HA, read replicas, point-in-time restore.

This file routes to the right reference. The step-by-step workflows live in ref/local.md and ref/cloud.md — read the one that matches the user's situation before running commands.

Which reference to use

The user wants to... Read
Develop or prototype locally, run tests/CI against Postgres, no cloud account needed ref/local.md
Go to production, host a managed Postgres, or use ClickHouse Cloud explicitly ref/cloud.md
Operate an existing cloud service (passwords, TLS, config, replicas, failover, restore) ref/cloud.md
Develop locally now, ship to production later Start with ref/local.md; it points to ref/cloud.md when it's time to go to prod

If it's genuinely ambiguous (e.g. "set up Postgres for my app"), default to local for development tasks and ask before creating anything in the cloud — cloud services cost money.

Prerequisites (both workflows)

Check that clickhousectl is installed:

which clickhousectl

If not found, install it:

curl -fsSL https://clickhouse.com/cli | sh

This installs to ~/.local/bin/clickhousectl (with a chctl alias). If the command is still not found, suggest export PATH="$HOME/.local/bin:$PATH" or a new terminal.

All commands accept --json for machine-readable output. Exit codes follow gh conventions: 0 success, 1 error, 2 cancelled, 4 auth required.

Related

  • To replicate Postgres data into ClickHouse for analytics, see ClickPipes (clickhousectl cloud clickpipe --help).
  • For ClickHouse itself (local development or ClickHouse Cloud services), use the infra-clickhouse skill.

Reproducido de ClickHouse/agent-skills bajo licencia Apache-2.0. Leer esta página en markdown.

Archivos

5 archivos en el paquete. Solo se lee SKILL.md al activarse — las referencias se cargan si el skill decide que las necesita.

Antes de instalar

Requiere tener instalado clickhousectl (o instalarlo vía curl -fsSL https://clickhouse.com/cli | sh).

Necesita en el PATH:curl

Detalles

Creador
ClickHouse
Categoría
Bases de datos
Licencia
Apache-2.0
Recursos incluidos
Incluye scripts o referencias
Código fuente
Ver SKILL.md

Etiquetas

Más de ClickHouse/agent-skills

Este repo incluye 11 skills. Si instalas uno, normalmente ya tienes los demás. Ver el pack agent-skills entero y su comando de instalación

Genera código TypeScript/JavaScript que lee/decodifica y escribe/codifica streams RowBinary de ClickHouse para el servidor HTTP; solo para Node.js, no cubre navegadores.

Costo de contexto al activarse
1.3k tok
Tamaño del paquete
193 archivos
Última actualización
hace 2 meses
Oficialbases de datos

Configura y gestiona ClickHouse con la CLI clickhousectl: servidor local para desarrollo y servicios ClickHouse Cloud gestionados para producción, incluyendo auth, esquemas y conexión.

Costo de contexto al activarse
661 tok
Tamaño del paquete
5 archivos
Última actualización
hace 2 meses
Oficialbases de datos

Conecta un colector OpenTelemetry a un servicio Managed ClickStack en ClickHouse Cloud, desplegando uno nuevo o configurando el existente, y envía telemetría sintética para verificarlo en ClickStack.

Costo de contexto al activarse
9.9k tok
Tamaño del paquete
2 archivos
Última actualización
hace 2 meses
Oficialdevops infraestructura

Escribe código idiomático para el cliente Node.js de ClickHouse (@clickhouse/client): configuración, ping, inserts, selects, parámetros, sesiones y tipos de datos. No usar para código de cliente Web/navegador.

Costo de contexto al activarse
2.8k tok
Tamaño del paquete
13 archivos
Última actualización
hace 3 meses
Oficialbases de datos

Soluciona problemas comunes del cliente Node.js de ClickHouse (@clickhouse/client): socket hang-up, Keep-Alive, streams, tipos de datos, TLS/proxy y timeouts.

Costo de contexto al activarse
1.3k tok
Tamaño del paquete
10 archivos
Última actualización
hace 3 meses
Oficialbases de datos

Úsalo obligatoriamente para investigar problemas de rendimiento en una instancia Postgres gestionada por ClickHouse: analiza métricas de Prometheus y patrones de consultas lentas, y recomienda (sin aplicar) una solución.

Costo de contexto al activarse
1.2k tok
Tamaño del paquete
13 archivos
Última actualización
hace 4 meses
Oficialbases de datos

Skills relacionados

Ejecuta SQL analítico con chDB, ClickHouse embebido en Python, sobre archivos locales, URLs, S3 o bases remotas (Postgres, MySQL, MongoDB, Iceberg, Delta Lake) sin servidor.

Costo de contexto al activarse
1.2k tok
Tamaño del paquete
8 archivos
Última actualización
hace 4 meses
Oficialbases de datos

Úsalo obligatoriamente al diseñar arquitecturas ClickHouse, elegir patrones de ingesta o modelado, o traducir buenas prácticas en diseños específicos del workload.

Costo de contexto al activarse
791 tok
Tamaño del paquete
15 archivos
Última actualización
hace 4 meses
Oficialbases de datos

Úsalo obligatoriamente al revisar schemas, queries o configuraciones de ClickHouse: contiene 31 reglas que deben verificarse antes de dar recomendaciones.

Costo de contexto al activarse
2.6k tok
Tamaño del paquete
37 archivos
Última actualización
hace 4 meses
Oficialbases de datos