clickhouse-architecture-advisor

Guide ClickHouse architecture decisions with provenance-labeled recommendation frameworks.

512|33|Updated Jan 15, 2026
One-click install
npx skills add https://github.com/ClickHouse/agent-skills --skill clickhouse-architecture-advisor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clickhouse-architecture-advisor
Source: https://github.com/ClickHouse/agent-skills/tree/main/skills/clickhouse-architecture-advisor
Command: npx skills add https://github.com/ClickHouse/agent-skills --skill clickhouse-architecture-advisor

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill provides workload-aware architecture decisioning for ClickHouse deployments, offering decision frameworks, provenance labeling, and structured guidance that translates best practices into workload-specific designs.

Core Features & Use Cases

  • Workload classification and architecture decisioning for ingestion, storage, and pre-aggregation.
  • Decision frameworks for ingestion strategies, time-series partitioning, enrichment path selection, and late-arriving data patterns.
  • Output contract guidance including workload summary, key decisions, provenance-labeled recommendations, target architecture, example SQL, and validation steps.
  • Explicit provenance management: official, derived, and field guidance with documented sources.

Quick Start

Describe an architecture design for a high-throughput real-time ClickHouse workload utilizing decision frameworks and explicit provenance labels.

Frequently Asked Questions about clickhouse-architecture-advisor

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

FAQPage Schema
How do I design a ClickHouse architecture for high-throughput real-time ingestion?

To design a ClickHouse architecture for real-time ingestion, this skill applies decision frameworks to classify your workload and generate a target architecture with provenance-labeled recommendations and example SQL.

What is the best way to partition time-series data in ClickHouse?

The best way to partition time-series data in ClickHouse is determined by using this skill's time-series retention design frameworks, which evaluate your workload to output structured partitioning strategies and validation steps.

When do I need materialized views for pre-aggregation in ClickHouse?

You need materialized views for pre-aggregation planning in ClickHouse when your analytics workload requires specific enrichment path selection, which this skill evaluates to produce pre-aggregation recommendations with explicit provenance tracking.

How do I handle late-arriving data patterns in ClickHouse ingestion strategies?

Handling late-arriving data patterns in ClickHouse ingestion strategies involves applying this skill's decision frameworks to assess your workload and output a structured ingestion strategy with official or field-derived guidance.

Does this ClickHouse architecture advisor provide official best practices or derived guidance?

This ClickHouse architecture advisor provides explicit provenance management, ensuring all workload analysis and architecture decisions are clearly labeled as official, derived, or field guidance with documented sources.

Can I get example SQL for my specific ClickHouse analytics workload?

You can get example SQL for your ClickHouse analytics workload by describing your scenario, which triggers the skill's output contract to generate target architecture designs, key decisions, and corresponding example SQL.