CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

clickhouse-io

ClickHouse database patterns, query optimization, analytics, and data engineering best practices for high-performance analytical workloads.

Quality

69%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./docs/ja-JP/skills/clickhouse-io/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

53%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A technically strong, example-rich ClickHouse reference with concrete executable SQL and TypeScript snippets, undermined by a monolithic single-file structure that inlines ~430 lines with zero progressive disclosure, a textbook overview section Claude doesn't need, and no validation feedback loops for its batch/insert/CDC operations. Splitting the analytics cookbook, monitoring, and pipeline patterns into reference files would address the biggest weaknesses.

Suggestions

Move the analytics query cookbook (retention/funnel/cohort), monitoring queries, and data-pipeline patterns into references/ files (e.g., ANALYTICS.md, MONITORING.md, PIPELINES.md), leaving SKILL.md as a concise overview with clearly signaled one-level-deep links.

Delete the introductory "概要" section and "主な機能" list — Claude already knows what ClickHouse and columnar OLAP databases are — and open with the table-design patterns directly.

Add validation/verification steps for batch operations: check insert results, verify row counts after bulk loads, and handle the CDC notification handler's failure path before continuing.

DimensionReasoningScore

Conciseness

The bulk is ClickHouse-specific code, which earns its place, but the opening explains concepts Claude already knows — "ClickHouseは、オンライン分析処理(OLAP)用のカラム指向データベース管理システム(DBMS)です" plus a "主な機能" list of column storage, compression, and parallel execution — textbook knowledge that should be cut. At ~430 lines in a single file, several sections (monitoring queries, analytics cookbook) could be tightened; this sits at the "mostly efficient but includes some unnecessary explanation" anchor rather than clearly verbose (2).

3 / 5

Actionability

Mostly executable, copy-paste-ready code: complete CREATE TABLE statements with engines/partitioning, concrete aggregate and window-function SQL, and working @clickhouse/client insert snippets. Not 5 because of minor gaps — the ETL example calls undefined helpers (`extractFromPostgres()`, `bulkInsertToClickHouse()`), and some queries reference columns (`trader_id`, `trade_size`) not present in any defined table DDL.

4 / 5

Workflow Clarity

The skill is pattern-organized with clear PASS/FAIL contrasts rather than a step sequence, which is acceptable for a reference skill, but it includes batch and streaming insert operations, ETL pipelines, and CDC sync with no validation or verification steps (no insert-result checks, row-count verification, or error-recovery guidance). Per the rubric's cap, batch operations without feedback loops cap workflow clarity at 3; it is not 2 because the sections are individually coherent and clearly sequenced within each example.

3 / 5

Progressive Disclosure

There are no bundle files at all (no references/, scripts/, or assets/), so the entire ~430-line reference — including a full analytics query cookbook (retention, funnel, cohort), monitoring queries, and pipeline code that clearly belongs in separate reference files — is inlined in SKILL.md. This matches the anchor for content that clearly belongs in separate files being inlined; it is not 3 because there are no references to signal or reorganize, and the inlining is more extensive than that anchor's example.

2 / 5

Total

12

/

20

Passed

Description

70%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A solid, third-person description that names a specific technology and several capability areas, with strong distinctiveness. Its main weakness is the absence of any explicit "Use when..." trigger clause and missing natural synonyms (OLAP, columnar, SQL) that would help discovery.

Suggestions

Add an explicit trigger clause, e.g., "Use when working with ClickHouse databases, writing ClickHouse SQL, optimizing analytical queries, or building data pipelines into a columnar OLAP store."

Include natural synonyms users would say — "OLAP", "columnar/column-store database", "real-time analytics" — to improve trigger-term coverage.

Replace the generic tail "data engineering best practices for high-performance analytical workloads" with concrete capabilities the body actually covers, such as table design (MergeTree engines), materialized views, and batch/streaming inserts.

DimensionReasoningScore

Specificity

The description lists several concrete capability areas — "database patterns, query optimization, analytics, and data engineering best practices" — which matches the anchor for several specific actions with minor gaps. It falls short of 5 because the actions are domain labels rather than concrete operations (e.g., no mention of table design, materialized views, or batch inserts that the body actually covers), and "best practices" is mildly generic.

4 / 5

Completeness

The "what" is clear (ClickHouse patterns, optimization, analytics, data engineering), but there is no "Use when..." or equivalent trigger clause, so the "when" is only weakly implied by the domain itself. Per the judging guideline, a missing 'Use when...' clause caps completeness at 3; it is not 2 because the "what" half is explicit and reasonably specific.

3 / 5

Trigger Term Quality

"ClickHouse" is the dominant natural trigger term a user would say, supported by "query optimization", "analytics", and "data engineering". Not 5 because common synonyms and variations users naturally say — "OLAP", "column-store/columnar database", "SQL", "real-time analytics" — are absent, and "high-performance analytical workloads" is jargon-heavy phrasing rather than user language.

4 / 5

Distinctiveness Conflict Risk

"ClickHouse" names a specific technology, giving the skill a clear niche with distinct triggers and minimal conflict risk — it would not fire for general SQL, PostgreSQL, or other database skills. It matches the anchor for a clear niche with distinct triggers.

5 / 5

Total

16

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

affaan-m/ECC

Path

docs/ja-JP/skills/clickhouse-io/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.