clickhouse-analytical-database-operations

clickhouse-analytical-database-operations is a skill for Claude Code from selvarajmurugesan90/ops-engineering-skills. It costs 132 tokens per session (4,017 once invoked), scanned A, original, Apache-2.0.

Guidance for operating ClickHouse, an open-source database designed to analyze very large datasets quickly. It covers table engines, distributed storage, replication, and materialized views, which precompute results as data arrives.

In plain words
What is it for?
Use it when designing ClickHouse tables, choosing MergeTree variants, setting up sharding or replication, and building streaming aggregations.
Why use it?
ClickHouse works differently from databases built for frequent individual record changes, so early design choices affect speed and growth. This guidance helps match its storage and cluster setup to the workload.

Skill for Claude Code

Written for Claude Code: shipped in a Claude Code plugin. Also seen: mentions Claude Code; mentions Codex; mentions Gemini CLI.

Part of the database-operations-skills plugin — 7 skills shipped together

Good fit Use it when designing ClickHouse tables, choosing MergeTree variants, setting up sharding or replication, and building streaming aggregations.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/selvarajmurugesan90/ops-engineering-skills/clickhouse-analytical-database-operations
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add selvarajmurugesan90/ops-engineering-skills --skill clickhouse-analytical-database-operations
Clone the repo
git clone --depth 1 https://github.com/selvarajmurugesan90/ops-engineering-skills

Made for: Claude Code.

Or install database-operations-skills, the plugin that ships this one along with the rest of its 7 skills.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for clickhouse-analytical-database-operations

README.md
[![agentmods](https://agentmods.dev/badge/skills/selvarajmurugesan90/ops-engineering-skills/clickhouse-analytical-database-operations/github.svg)](https://agentmods.dev/skills/selvarajmurugesan90/ops-engineering-skills/clickhouse-analytical-database-operations)
Your own site
<a href="https://agentmods.dev/skills/selvarajmurugesan90/ops-engineering-skills/clickhouse-analytical-database-operations"><img src="https://agentmods.dev/badge/skills/selvarajmurugesan90/ops-engineering-skills/clickhouse-analytical-database-operations/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for clickhouse-analytical-database-operations

Your own site · 80×15
<a href="https://agentmods.dev/skills/selvarajmurugesan90/ops-engineering-skills/clickhouse-analytical-database-operations"><img src="https://agentmods.dev/badge/skills/selvarajmurugesan90/ops-engineering-skills/clickhouse-analytical-database-operations.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 132 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 4,017 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe. Third-party audits
  • NVIDIA SkillSpector pass 7 Sept 2026
How audits are shown
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00132 $0.04017
Opus 5 $0.00066 $0.02008
Sonnet 5 $0.00026 $0.00803
Haiku 4.5 $0.00013 $0.00402

Measured 11d ago against content hash 7ec8fd7a265f, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-11, from the pricing page.

Security

Grade A, and why

clickhouse-analytical-database-operations scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 11d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

plugins/database-operations/skills/clickhouse-analytical-database-operations/SKILL.md · 372 lines

How it starts

The opening of the file, as written. The whole thing — 372 lines — stays where its author put it; the contents beside it link to each section on GitHub.

ClickHouse Analytical Database Operations

Purpose

ClickHouse is a column-oriented OLAP database built for aggregating billions of rows in sub-second time, at the cost of assumptions that are the opposite of a typical OLTP engine: it favors large batched inserts over row-by-row writes, has no transactional multi-row UPDATE/ DELETE in the traditional sense (mutations are async, heavyweight background rewrites), and gets its performance almost entirely from choosing the right member of the MergeTree engine family and a sensible sharding/replication topology up front. This skill covers those foundational decisions — engine selection, ReplicatedMergeTree plus Distributed tables for a sharded/replicated cluster, and materialized views for streaming aggregation — the operational core that determines whether a ClickHouse deployment stays fast as data volume grows.

When to use

  • Designing a new ClickHouse table and choosing among MergeTree, ReplacingMergeTree, SummingMergeTree, AggregatingMergeTree, or CollapsingMergeTree/VersionedCollapsingMergeTree for the table's actual update/deduplication pattern.
  • Setting up a sharded and/or replicated ClickHouse cluster (ReplicatedMergeTree plus Distributed table engine) for scale-out or fault tolerance.
  • Query performance is poor despite the right engine choice — usually a partition/order-by key mismatch with actual query filters.
  • Building a materialized view to maintain a pre-aggregated rollup incrementally as data is inserted, instead of aggregating raw high-cardinality data on every query.
  • Diagnosing excessive background merge activity, "too many parts" errors, or a mutation (ALTER TABLE ... UPDATE/DELETE) that's taking much longer than expected.

Prerequisites & environment

  • ClickHouse 23.x/24.x assumed for the syntax below; note that ReplicatedMergeTree historically required ZooKeeper for replica coordination, while ClickHouse Keeper (clickhouse-keeper, a ClickHouse-native reimplementation of the ZooKeeper protocol) is now the recommended coordination layer for new deployments — check which your cluster uses before assuming ZooKeeper-specific tooling applies.
  • A coordination service (ClickHouse Keeper or ZooKeeper, an odd number of nodes — 3 minimum) reachable by every node, required for any Replicated* table engine to coordinate replica state and part assignment.
  • Cluster topology defined in config.xml/cluster.xml (<remote_servers>) so Distributed tables know the shard/replica layout — this is infrastructure configuration, not something set per-query.
  • Enough disk headroom for background merges: ClickHouse periodically merges smaller data parts into larger ones, and a merge briefly requires space for both the source parts and the resulting merged part simultaneously.
  • Client access via the native protocol (port 9000) or HTTP interface (port 8123); clickhouse-client for interactive administration.

Read the full file on GitHub · 372 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 11d ago First seen · 372 lines · 132 tokens per session scan A 7ec8fd7a265f

Subscribe to this mod's changes

clickhouse-analytical-database-operations is a skill published in the GitHub repository selvarajmurugesan90/ops-engineering-skills (38 stars, last pushed 1mo ago), licensed Apache-2.0. It adds 132 tokens to every session and 4,017 once invoked, about $0.0007 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

create-pr

Creates a GitHub PR with a Linear-ticket-prefixed title and a decision-led, narrative description for prisma-next. Use when the user wants to create a pull request, open a PR, or submit changes for review.

prisma/orm · 47 tokens

schema-exploration

Lists tables, describes columns and data types, identifies foreign key relationships, and maps entity relationships in a database. Use when the user asks about database schema, table structure, column types, what tables exist, ERD, foreign keys, or how entities relate.

langchain-ai/deepagents · 57 tokens

ha-data-stores

Map of Hope Agent's local data stores and safe read-only query workflow. Use when the user asks where Hope Agent stores data, wants to inspect sessions/messages/memory/logs/background jobs/knowledge indexes/settings, asks the model to query local app data, or debugging requires checking persisted state. Trigger…

shiwenwen/hope-agent · 115 tokens

supabase

Supabase / PostgREST Row-Level-Security playbook — pull the anon (or leaked servicerole) key out of the frontend JS, map tables from the auto-generated OpenAPI spec, test anonymous RLS READ disclosures (PII/secret leaks), and anonymous RLS WRITE abuse (insert/update/delete — e.g. forging…

PentesterFlow/agent · 120 tokens

nornicdb-cypher-queries

Pick fast, predictable Cypher query shapes in NornicDB — point lookups, batch retrieval, pagination, search, traversal, batched UNWIND/MERGE writes, cleanup, multi-tenant isolation. Use when writing or reviewing Cypher whose latency or throughput matters; maps user intent to the executor's hot-path query templates.

orneryd/NornicDB · 79 tokens

dsql

Build with Aurora DSQL — manage schemas, execute queries, handle migrations, diagnose query plans, diagnose cluster performance, load data, and develop applications with a serverless, distributed SQL database. Covers IAM auth, multi-tenant patterns, MySQL-to-DSQL and PostgreSQL-to-DSQL schema conversion, foreign key…

awslabs/agent-plugins · 229 tokens