Skip to main content

AI Skills for ClickHouse® DB

Teach your AI assistant to design schemas, optimize queries, and build materialized views. One command to install.

View on GitHub
Terminal
$ npx add-skill obsessiondb/clickhouse-skills

What are skills?

Skills are instruction packages for AI coding assistants. When you ask your AI to “create a ClickHouse table,” it loads the relevant skill and follows best practices automatically.

Each skill encodes the rules and patterns that ClickHouse experts use every day. No prompt engineering needed. Install once, use anywhere.

  • Works offline in your local environment
  • No data leaves your machine
  • 45+ rules across 3 specialized skills
45+
Expert rules encoded
3
Specialized skills
Free
Open source forever

Three skills, one install

From schema design to query optimization. Each skill encodes real-world ClickHouse expertise.

Schema Design

15+ rules

Optimal ORDER BY, PARTITION BY, and TTL for 10x compression and sub-second queries on billions of rows.

SCHEMASORDER BYTTL

Query Optimization

20+ rules

Debug slow joins, fix memory errors, and write performant queries. 10-100x faster, 90% less memory.

slow queryJOINPREWHERE

Materialized Views

10+ rules

Real-time aggregation with SummingMergeTree, AggregatingMergeTree, and battle-tested MV patterns.

MVsAggregateFunctionMergeTree

How it works

01

Install the skills

One command adds all three ClickHouse skills to your project.

npx add-skill obsessiondb/clickhouse-skills
02

Ask in plain English

Your AI detects the task and loads the right skill automatically.

"Create a table for event analytics with 90-day TTL"
03

Get expert output

The AI follows 45+ rules to produce production-grade ClickHouse code.

-- Optimal schema: ORDER BY, PARTITION BY, TTL

Works with

Claude CodeOpenAI CodexCursorVS Code CopilotGemini CLIAny AI agent

Start building better

Sub-second queries. 10x compression. Zero full table scans. Let your AI do it right.