CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

clickhouse

ClickHouse integration. Manage data, records, and automate workflows. Use when the user wants to interact with ClickHouse data.

Quality

65%

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 ./skills/clickhouse/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

57%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.

The body delivers mostly executable CLI guidance with a solid connection-state feedback loop, but it opens with padding Claude doesn't need, contains a broken "Step 2" sequence and an empty "Popular actions" section, and lacks post-execution validation for database operations. Tightening the intro, fixing step labels, and adding error-handling guidance after action runs would raise most dimensions.

Suggestions

Delete the "ClickHouse is a fast open-source column-oriented database..." intro paragraph and the "ClickHouse Overview" bullet list — Claude already knows what ClickHouse is; keep only the official docs link.

Fix the workflow numbering (label "Step 1a/1b/2" or drop the "skip to Step 2" references) and consolidate the duplicated `action list` guidance from "Popular actions" into "Searching for actions" with a worked example (real action name + sample input/output).

Add validation/error-handling guidance after running actions and proxy requests (check the `output` and `error` fields, retry or inspect the connection state on failure), since these are database operations where feedback loops are expected.

DimensionReasoningScore

Conciseness

The opening paragraph ("ClickHouse is a fast open-source column-oriented database management system... web analytics, advertising networks, and IoT platforms") explains a concept Claude already knows, and the "ClickHouse Overview" bullet list ("Query / Query ID / ClickHouse / Cluster / Database / Table") plus "Use action names and parameters as needed" is filler. The rest is mostly efficient command examples, so it sits at anchor 3 — could be tightened, but not the pervasive padding of anchor 2.

3 / 5

Actionability

Concrete executable commands throughout: `npm install -g @membranehq/cli@latest`, `membrane login complete <code>`, `membrane connection ensure "https://clickhouse.tech/" --json`, `membrane action run <actionId> --connectionId=... --input '{"key": "value"}'`, plus a proxy options table. Minor gaps keep it below anchor 5: no worked example with a real action id or sample output, the `membrane request` section shows flags but no end-to-end example, and the CLI is invoked inconsistently (`membrane` vs `npx @membranehq/cli`).

4 / 5

Workflow Clarity

The connect → wait-for-READY → search-actions → run sequence exists with a real feedback loop for connection state polling (`--wait`, `CLIENT_ACTION_REQUIRED` handling, re-poll after user action). But the flow is undermined by dangling references ("skip to **Step 2**" when no Step 2 is labeled, a lone "1b" heading), and there are no validation/error-handling checkpoints after running actions or proxy requests against the database — per the rubric's database-operations note this caps workflow clarity at 3.

3 / 5

Progressive Disclosure

The single-file skill has reasonable section headers but organizational gaps: the "Popular actions" section is nearly empty and duplicates the `action list` command already shown in "Searching for actions", and the proxy flag table and clientAction reference would sit better in a separate reference file for a ~140-line body. It is above anchor 2 (structure exists and nothing is a monolithic wall) but below anchor 4 due to the redundancy and unclear split.

3 / 5

Total

13

/

20

Passed

Description

57%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.

The description has an explicit 'Use when' trigger and a distinctive domain term, but the capability statement is generic boilerplate that could describe almost any data integration. Adding concrete ClickHouse operations (run queries, insert data, manage tables/databases) and natural trigger synonyms (SQL, query, insert) would lift specificity and trigger quality.

Suggestions

Replace "Manage data, records, and automate workflows" with concrete actions, e.g. "Run SQL queries, insert and export data, and manage ClickHouse databases, tables, and clusters."

Expand the trigger clause with natural user phrases: "Use when the user mentions ClickHouse, wants to run SQL queries or insert/export data, or asks about their ClickHouse database."

Avoid generic filler ("records", "automate workflows") that overlaps with other data-integration skills and dilutes the distinct ClickHouse niche.

DimensionReasoningScore

Specificity

"Manage data, records, and automate workflows" names the ClickHouse domain but the actions are minimal or generic — no concrete operations like running queries, inserting rows, creating tables, or managing databases appear. It is above anchor 1 (there is a named domain and verbs, not pure abstraction) but does not reach anchor 3, which requires 1-2 genuinely concrete actions.

2 / 5

Completeness

It has both a 'what' ("Manage data, records, and automate workflows") and an explicit 'when' ("Use when the user wants to interact with ClickHouse data"), so the missing-trigger cap of 3 does not apply. It falls short of anchor 5 because the 'what' is generic boilerplate rather than concrete capabilities, and the trigger lacks specific phrases.

4 / 5

Trigger Term Quality

"Use when the user wants to interact with ClickHouse data" includes the distinctive term "ClickHouse" plus "data", but misses the natural phrases users would say — "run/query", "SQL", "insert", "database", "create table". Matches anchor 3 (some relevant keywords but missing common variations) rather than anchor 4's good coverage.

3 / 5

Distinctiveness Conflict Risk

The named trigger "ClickHouse" gives it a clear niche with minimal conflict risk, but the generic "Manage data, records, and automate workflows" tail could overlap with other data-integration or database skills. Mostly distinct with minor overlap risk (anchor 4) rather than the fully distinct anchor 5.

4 / 5

Total

13

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

membranedev/application-skills

Path

skills/clickhouse/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.