altinity-expert-clickhouse-schema

Identify schema design issues in ClickHouse tables and present actionable fixes.

16|2|Updated Jan 8, 2026
One-click install
npx skills add https://github.com/Altinity/Skills --skill altinity-expert-clickhouse-schema-altinity
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: altinity-expert-clickhouse-schema
Source: https://github.com/Altinity/Skills/tree/main/altinity-expert-clickhouse/skills/altinity-expert-clickhouse-schema
Command: npx skills add https://github.com/Altinity/Skills --skill altinity-expert-clickhouse-schema-altinity

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Analyzes ClickHouse table structure to identify design anti-patterns and optimization opportunities, enabling faster design decisions and better performance.

Core Features & Use Cases

  • Analyze table schema, including partitions, ORDER BY keys, and materialized views, to surface design issues.
  • Recommend concrete improvements for partitioning, compression, and MV usage to optimize query performance and storage.
  • Use case: before deploying a new analytical workload, scan existing schemas to identify high-risk patterns and propose design changes.

Quick Start

Run a schema health check against your ClickHouse deployment to reveal design issues and optimization opportunities.

Frequently Asked Questions about altinity-expert-clickhouse-schema

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

FAQPage Schema
How do I identify ClickHouse schema design anti-patterns in my tables?

To identify ClickHouse schema design anti-patterns, run a schema health check that analyzes table partitions, ORDER BY keys, and materialized views to surface high-risk structural flaws and optimization opportunities across your databases.

What is the best way to optimize ClickHouse partitioning and ORDER BY keys?

The best way to optimize ClickHouse partitioning and ORDER BY keys is to analyze your table schema to detect design flaws, which generates concrete recommendations and guardrails for restructuring your data storage and improving query performance.

How do I analyze materialized views in ClickHouse for performance optimization?

You can analyze materialized views in ClickHouse for performance optimization by scanning your table schemas to detect design issues and receiving actionable fixes to improve MV usage, column compression, and overall query execution speed.

Do I need access to system tables to check my ClickHouse schema for optimization opportunities?

Yes, you need access to ClickHouse system tables and standard metadata to check your schema for optimization opportunities, as this access is required to generate robust recommendations and design guardrails across your databases and tables.

When should I scan existing ClickHouse schemas for design issues?

You should scan existing ClickHouse schemas for design issues before deploying a new analytical workload, allowing you to proactively identify high-risk patterns in partitioning and compression and propose necessary design changes for optimization.