clickhouse-best-practices

Apply ClickHouse best-practice rules to schema design, query optimization, and ingestion configuration.

1.6k|107|Updated Feb 15, 2026
One-click install
npx skills add https://github.com/Makisuo/maple --skill clickhouse-best-practices-makisuo
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: clickhouse-best-practices
Source: https://github.com/Makisuo/maple/tree/main/.agents/skills/clickhouse-best-practices
Command: npx skills add https://github.com/Makisuo/maple --skill clickhouse-best-practices-makisuo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill provides a structured rule-based framework to guide reviews and recommendations for ClickHouse schemas, queries, and data-ingestion configurations, ensuring performance and correctness.

Core Features & Use Cases

  • 28 atomic rules organized into schema, query, and insert categories that enforce best practices before giving recommendations.
  • Formal review workflow that requires citing specific rules, cross-referencing official ClickHouse docs, and maintaining consistency across deployments.
  • Use cases include designing primary keys, partitioning strategies, data types, joining strategies, materialized views, and mutation avoidance.

Quick Start

Inspect the 28 rules under rules/ and cite applicable ones when making recommendations.

Frequently Asked Questions about clickhouse-best-practices

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

FAQPage Schema
How do I design a primary key and partitioning strategy in ClickHouse?▼

Apply ClickHouse best-practice rules for primary key planning and partitioning strategies to structure schema design, requiring citations to specific rules and cross-referencing official documentation to ensure production performance.

What are the best practices for ClickHouse query optimization?▼

ClickHouse query optimization involves applying atomic rules that enforce best practices for joining strategies and materialized views, requiring formal citations to specific rules before giving recommendations.

Why should I avoid mutations in ClickHouse production deployments?▼

Avoiding ClickHouse mutations is enforced by atomic best-practice rules because they are heavy background operations, and this skill requires citing specific rules to maintain consistency and correctness across production deployments.

How do I configure data types and ingestion for ClickHouse?▼

Configure ClickHouse data types and ingestion by applying rule-based checks from the insert and schema categories, ensuring data type selection aligns with official Best Practices documentation before generating recommendations.

Can I use this rule-based framework for ClickHouse schema reviews?▼

Yes, you can use the 28 atomic rules organized into schema, query, and insert categories to perform formal ClickHouse schema reviews, requiring citations to specific rules and cross-referencing official docs.

What are the limitations of relying on ClickHouse best practices?▼

The limitation is that this framework enforces strict rule-based checks and requires citations to specific rules and official documentation, meaning recommendations cannot bypass the 28 atomic rules governing schema, query, and insert configurations.