Skip to skills
AI Craft Pad
Home/Skills/Data & databases/clickhouse-best-practices
First-party source

Clickhouse Best Practices

A structured review of ClickHouse schema, query and insertion choices with links to focused rules.

Editorial review checked 2026-10-29 against this instruction snapshot. Supporting scripts and runtime behavior remain outside this editorial review.

What it does

The source organizes a broad rule library around storage layout, data types, query execution and ingestion. It also routes connection and query-safety setup separately. Its useful output is a traceable list of checked rules and concrete findings, rather than an unexplained claim that a schema is optimized.

Best for

Reviewing an existing ClickHouse design or preparing a change to sort keys, partitions, joins or batching behavior.

Tradeoffs and requirements

This is specific to ClickHouse; generic relational indexing intuition can mislead. Rule coverage is not exhaustive, and repository instructions can lag product releases. Administrative commands and heavy diagnostic queries require their own permission and resource review.

Unknown; inspect source requirements and supporting scripts.

Install from the source

Inspect the pinned source snapshot and its supporting files first. The command selects this skill through the open-source skills CLI. Node.js and agent-specific setup may be required. Installation can download code; this catalog never runs it.

npx skills add https://github.com/ClickHouse/agent-skills/tree/69a8354b05b5942e5cea77b6c87be7788303fc18/skills/clickhouse-best-practices --skill clickhouse-best-practices

Review pinned skill folder ↗ · CLI documentation ↗

After source review, use npx skills check and npx skills update to inspect and apply upstream updates. Re-check changed instructions before running them.

Safety & review signals

Static review only. This is not a security audit or a guarantee of safety.

SKILL.md text only; scripts, dependencies and runtime behavior not audited.

  • Credential Reference — review the source context.
  • Network Access — review the source context.

Allowed tools declaration: Unknown. Runtime permissions and network behavior: Unknown.

AI Craft Pad Skill Score

86/100 · Metadata coverage 100% · Model 1.0

Scores summarize observable discovery signals. Popularity and repository activity apply to the whole repository. Unknown runtime safety earns no certification.

Documentation
100/100
100
Maintenance
100/100
100
License Clarity
100/100
100
Repository Health
100/100
100
Compatibility Evidence
80/100
80
Popularity
50/100
50
Originality
80/100
80
Static Safety
60/100
60
Read the formula and limits →

Suggested workflow

Identify the table engine and representative query predicates, then read only the matching schema and query references. Prioritize findings by their measured effect on the actual workload.

How to judge the result

Compare query plans and resource usage before and after a proposed change on a bounded fixture. Verify insertion behavior and retention needs as well as read latency; avoid destructive experiments on the only copy of a table.

Similar skills to compare

Related by category; compare scope and dependencies before choosing an alternative.

Data & databases87/100

360 feedback system

sickn33/agentic-awesome-skills

Explore 360 feedback system as a data & databases workflow from sickn33/agentic-awesome-skills. Compare its source, maintenance and review signals before choosing it for your agent.

Community sourceMIT3 matching source records
48,737 repo stars1 text flagReview ↗
Data & databases87/100

access matrix

sickn33/agentic-awesome-skills

Explore access matrix as a data & databases workflow from sickn33/agentic-awesome-skills. Compare its source, maintenance and review signals before choosing it for your agent.

Community sourceMIT3 matching source records
48,737 repo stars1 text flagReview ↗
Data & databases87/100

adhx

sickn33/agentic-awesome-skills

Explore adhx as a data & databases workflow from sickn33/agentic-awesome-skills. Compare its source, maintenance and review signals before choosing it for your agent.

Community sourceMIT3 matching source records
48,737 repo stars3 text flagsReview ↗

More from this source

Data & databases86/100

chdb datastore

ClickHouse/agent-skills

A Python DataFrame workflow for exploring files and joining tabular sources through the embedded ClickHouse engine.

First-party sourceApache-2.0Editorial review
562 repo stars2 text flagsReview ↗
Data & databases86/100

chdb sql

ClickHouse/agent-skills

Embedded analytical SQL for Python tasks that need ClickHouse functions without operating a separate database server.

First-party sourceApache-2.0Editorial review
562 repo stars2 text flagsReview ↗
Data & databases86/100

clickhouse architecture advisor

ClickHouse/agent-skills

A workload-first decision aid for ClickHouse ingestion, enrichment, time-series storage and changing data.

First-party sourceApache-2.0Editorial review
562 repo stars0 text flagsReview ↗