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.