Agent Skills › vemetric/vemetric › infra-clickhouse

infra-clickhouse

GitHub

使用 clickhousectl 管理 ClickHouse,支持本地开发环境搭建与生产环境(ClickHouse Cloud)部署、迁移及运维。

.agents/skills/infra-clickhouse/SKILL.md vemetric/vemetric

触发场景

设置本地 ClickHouse 开发环境 创建或管理 ClickHouse Cloud 生产服务 执行 ClickHouse 模式迁移 应用连接 ClickHouse

安装

npx skills add vemetric/vemetric --skill infra-clickhouse -g -y
更多选项

非标准路径

npx skills add https://github.com/vemetric/vemetric/tree/main/.agents/skills/infra-clickhouse -g -y

不安装直接使用

npx skills use vemetric/vemetric@infra-clickhouse

指定 Agent (Claude Code)

npx skills add vemetric/vemetric --skill infra-clickhouse -a claude-code -g -y

安装 repo 全部 skill

npx skills add vemetric/vemetric --all -g -y

预览 repo 内 skill

npx skills add vemetric/vemetric --list

SKILL.md

Frontmatter
{
    "name": "infra-clickhouse",
    "license": "Apache-2.0",
    "metadata": {
        "author": "ClickHouse Inc",
        "version": "0.3.0"
    },
    "description": "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."
}

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.

Related

  • 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.

版本历史

  • 4e8800b 当前 2026-09-28 16:05

同 Skill 集合

.agents/skills/clickhouse-architecture-advisor/SKILL.md
.agents/skills/clickhouse-best-practices/SKILL.md
.agents/skills/clickhouse-js-node-coding/SKILL.md
.agents/skills/redis-clustering/SKILL.md
.agents/skills/redis-connections/SKILL.md
.agents/skills/redis-core/SKILL.md
.agents/skills/redis-observability/SKILL.md
.agents/skills/redis-security/SKILL.md
.agents/skills/chdb-datastore/SKILL.md
.agents/skills/chdb-sql/SKILL.md
.agents/skills/clickhouse-js-node-troubleshooting/SKILL.md
.agents/skills/redis-search/SKILL.md

元信息

文件数
0
版本
2c917f7
Hash
f061bca1
收录时间
2026-09-28 16:05

首页 - Wiki
Copyright © 2011-2026 iteam. Current version is 2.156.0. UTC+08:00, 2026-11-21 16:28
浙ICP备14020137号-1