clickhouse/agent-skills1k installs

infra-clickhouse

Q: How do I install this agent skill?

Run npx skills add https://github.com/clickhouse/agent-skills --skill infra-clickhouse.

Q: Is this agent skill safe to install?

Review the displayed partner audits, complete source, permissions, dependencies, and exact revision before installing.

Sets up and manages ClickHouse using the clickhousectl CLI — installs and runs a local ClickHouse server for development, and creates managed ClickHouse Cloud services for production (authentication, service creation, schema migration, application connection). Use when the user wants to build an application with ClickHouse, set up a local ClickHouse dev environment, create tables and start querying, deploy ClickHouse to production or ClickHouse Cloud, or migrate from a local setup to the cloud.

How do I install this agent skill?

npx skills add https://github.com/clickhouse/agent-skills --skill infra-clickhouse

view source ↗

Is this agent skill safe to install?

Gen Agent Trust Hubpass
This skill provides standard workflows for managing ClickHouse databases using the clickhousectl CLI. It includes instructions for installing the CLI, setting up local development environments, and deploying to ClickHouse Cloud. The skill correctly follows security best practices by advising users to gitignore sensitive environment files, suggesting the creation of dedicated application users with limited permissions, and instructing users to handle authentication tokens in separate terminal sessions to avoid chat history exposure. The remote installation command is sourced from the vendor's official domain.
Socketpass
No alerts
Snykwarn
Risk: MEDIUM · 1 issue

What does this agent skill do?

ClickHouse with clickhousectl

clickhousectl manages ClickHouse in two environments:

Local — ClickHouse installed and running on the user's machine, for development.
Cloud — managed ClickHouse Cloud services, for production: fully managed, automatic scaling, backups, and upgrades.

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
Build an app with ClickHouse, develop or prototype locally, no cloud account needed	ref/local.md
Go to production, host a managed ClickHouse, or use ClickHouse Cloud explicitly	ref/cloud.md
Operate an existing cloud service (schemas, users, queries against it)	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 ClickHouse 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.

When designing schemas, consult the clickhouse-best-practices skill for ORDER BY selection, data types, and partitioning.
For Postgres (local development or managed ClickHouse Cloud Postgres), use the infra-postgres skill.

How can the creator link this skill?

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/clickhouse/agent-skills/infra-clickhouse">View infra-clickhouse on skillZs</a>