clickhouse-docs

Diagnose ClickHouse documentation gaps across engines, SQL syntax, and troubleshooting.

7|2|Updated Feb 25, 2026
One-click install
npx skills add https://github.com/wenerme/ai --skill clickhouse-docs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clickhouse-docs
Source: https://github.com/wenerme/ai/tree/main/skills/clickhouse-docs
Command: npx skills add https://github.com/wenerme/ai --skill clickhouse-docs

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

The clickhouse-docs skill helps you quickly find correct ClickHouse concepts, SQL syntax, and operational guidance so you can design tables, troubleshoot errors, and optimize performance without guessing.

Core Features & Use Cases

  • ClickHouse SQL & engine reference: Covers data types, table engines (including MergeTree family), functions, dictionaries, and materialized views for accurate query and schema design.
  • Data modeling guidance: Explains denormalization, sharding, replication, and schema design tradeoffs to fit analytics requirements.
  • Integrations and deployment: Documents Kafka/S3/RDBMS integrations, ClickHouse Cloud setup, Kubernetes operator usage, and operational workflows.
  • Troubleshooting via knowledge base: Provides expert guidance for common failures and settings-based resolutions (e.g., query limits, INSERT…SELECT issues, access/auth problems).

Quick Start

Ask about the specific ClickHouse feature or error you are facing, for example: "How do I resolve the TOO_MANY_PARTS error during INSERT…SELECT and which settings should I tune?"

Frequently Asked Questions about clickhouse-docs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I design a MergeTree schema for optimal ClickHouse query performance?

ClickHouse MergeTree schema design involves selecting appropriate sorting keys and partitioning strategies to optimize query performance. This skill provides data modeling guidance on denormalization and schema design tradeoffs tailored to your analytics requirements.

Why does ClickHouse throw a TOO_MANY_PARTS error during INSERT…SELECT operations?

The TOO_MANY_PARTS error occurs when ClickHouse creates data parts faster than they merge. This skill provides troubleshooting guidance to identify settings-based resolutions and tune parameters for INSERT…SELECT operations.

Can I use ClickHouse Cloud and the Kubernetes operator for production deployments?

ClickHouse Cloud and the Kubernetes operator are supported for deployment. This skill documents ClickHouse Cloud setup, Kubernetes operator usage, and operational workflows to manage your analytics infrastructure.

What is the best way to integrate ClickHouse with Kafka and S3 for data ingestion?

Integrating ClickHouse with Kafka and S3 involves using specific table engines and functions for external data access. This skill provides reference documentation for configuring integrations with external systems including RDBMS.

How do materialized views and dictionaries work in ClickHouse SQL?

Materialized views and dictionaries in ClickHouse automate data aggregation and dimension lookups. This skill covers table engines, functions, dictionaries, and materialized views to support accurate query construction and schema design.